Documentation sur Oracle Cloud Infrastructure

Création d'un outil d'appel de point d'extrémité d'API dans les agents d'intelligence artificielle générative

Dans les agents d'IA générative, chaque agent doit avoir un ou plusieurs outils. Vous pouvez créer l'outil d'un agent pendant ou après sa création. Pour les deux options, la création d'un outil a les mêmes étapes. Cette section présente les étapes de création d'un outil d'appel de point d'extrémité d'API.

Avant de commencer, consultez les directives relatives aux outils d'appel de point d'extrémité d'API pour les agents d'IA générative et effectuez les tâches requises. Par exemple, vous devrez peut-être créer une clé secrète de chambre forte OCI et ajouter des politiques pour accéder aux clés secrètes de chambre forte.

Création d'un outil d'appel de point d'extrémité d'API

  1. Sélectionnez Créer un outil, puis Outil personnalisé.
  2. Entrez un nom et une description pour cet outil.
  3. Dans Configuration de l'outil, sélectionnez Appel de point d'extrémité d'API (exécution d'agent).
  4. (Facultatif) Sélectionnez un exemple, s'il y a lieu.

    Si vous sélectionnez un exemple, l'exemple est copié dans la zone Schéma d'API pour l'importation insérée. Passez à l'étape 6.

  5. Pour Importer un schéma d'API, sélectionnez l'une des options suivantes pour fournir le schéma d'API pour cet outil. Un schéma d'API décrit les opérations et les méthodes de point d'extrémité d'API.
    • Dans le corps du message : Pour un petit schéma, vous pouvez entrer une chaîne contenant les opérations et les méthodes de point d'extrémité d'API.
    • Sélectionner dans le stockage d'objets : Pour un schéma ou un schéma volumineux comportant des mises à jour fréquentes, sélectionnez un compartiment et un seau. Sélectionnez ensuite le fichier contenant le schéma d'API.
  6. Pour Type d'authentification, sélectionnez l'une des options suivantes et terminez la configuration de l'outil selon les besoins.
    • Aucun : Pour appeler des points d'extrémité d'API publics ou privés qui ne nécessitent pas d'authentification. Lorsqu'elle est sélectionnée, aucun en-tête d'authentification n'est ajouté à une demande d'appel.
    • Clé d'API : Une clé d'API est un jeton fourni par un client lors d'appels d'API. La clé d'API doit être stockée dans une clé secrète du service de chambre forte OCI.
      • Emplacement de la clé : Spécifiez l'emplacement de la clé d'API dans une demande d'appel.
        • Sélectionnez En-tête pour envoyer la clé dans l'en-tête de la demande.
        • Sélectionnez Paramètre d'interrogation pour transmettre la clé en tant que paramètre d'interrogation dans la demande.
      • Nom de clé : Entrez le nom d'une clé d'en-tête (par exemple, Authorization) ou le nom de clé d'un paramètre d'interrogation (par exemple, appid).
      • Sélectionner une clé secrète de chambre forte : Dans le compartiment approprié, sélectionnez la clé secrète du service de chambre forte OCI qui contient la clé d'API.
    • De base : Authentification de base HTTP à l'aide d'un nom d'utilisateur et d'un mot de passe. Les données d'identification doivent être spécifiées dans le format <your-username>:<your-password> et stockées dans une clé secrète du service de chambre forte OCI.
      • Sélectionner une clé secrète de chambre forte : Dans le compartiment approprié, sélectionnez la clé secrète du service de chambre forte OCI qui contient les données d'identification dans le format requis.
    • Porteur : Authentification OAuth 2.0 à l'aide d'un jeton de porteur. Le jeton doit être stocké dans une clé secrète du service de chambre forte OCI.
      • Sélectionner une clé secrète de chambre forte : Dans le compartiment approprié, sélectionnez la clé secrète du service de chambre forte OCI qui contient le jeton.
    • IDCS : Authentification OAuth 2.0 à l'aide de l'ID client et de la clé secrète client obtenus à partir d'une application confidentielle Oracle Identity Cloud Service (IDCS). La clé secrète client doit être stockée dans une clé secrète du service de chambre forte OCI.
      • Domaine d'identité : Dans le compartiment approprié, sélectionnez le domaine d'identité dans lequel créer cet outil.
      • ID client : Entrez l'ID client de l'application confidentielle.
      • Clé secrète client : Dans le compartiment approprié, sélectionnez la clé secrète du service de chambre forte OCI qui contient la clé secrète client pour l'application confidentielle.
      • URL d'étendue : Entrez l'URL d'étendue qui définit un jeu spécifique de ressources et d'opérations accessibles.
    • Principal de ressource OCI : Uniquement pour appeler des API de service OCI telles que le stockage d'objets, le calcul et le réseau (VCN et sous-réseau).
  7. Dans le compartiment approprié, sélectionnez le VCN et le sous-réseau à utiliser.
  8. Sélectionnez Créer un outil.
Conseil

Effectuez une des actions suivantes :

  • Si vous créez un agent, retournez à Création d'un agent dans des agents d'IA générative pour créer un autre outil ou un point d'extrémité d'agent.
  • Si vous avez ajouté l'outil à un agent existant, une fois l'outil actif, dans la page de détails de l'agent, sélectionnez Lancer le clavardage pour clavarder avec l'agent à l'aide de cet outil.
  • Si vous avez créé l'agent sans point d'extrémité d'agent, lorsque vous êtes prêt à l'utiliser, créez un point d'extrémité pour cet agent.
Note

Pour permettre à un réviseur humain de surveiller et de modifier une réponse avant de l'envoyer à l'utilisateur, sélectionnez la fonction facultative Activer l'humain dans la boucle dans le point d'extrémité de l'agent.