Documentation Oracle Cloud Infrastructure

Création d'un outil d'appel d'adresse d'API dans les agents d'IA générative

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

Avant de commencer, consultez les instructions de l'outil d'appel d'adresse d'API pour les agents d'IA générative et effectuez toutes les tâches requises. Par exemple, vous devrez peut-être créer une clé secrète OCI Vault et ajouter des stratégies pour accéder aux clés secrètes de coffre.

Création d'un outil d'appel d'adresse d'API

  1. Sélectionnez Créer un outil, puis Outil personnalisé.
  2. Saisissez le nom et la description de cet outil.
  3. Dans Configuration d'outil, sélectionnez Appel d'adresse d'API (exécution d'agent).
  4. (Facultatif) Sélectionnez un exemple, le cas échéant.

    Si vous sélectionnez un exemple, celui-ci est copié dans la zone Schéma d'API pour l'import Inline. Passez à l'étape 6.

  5. Pour Importer le schéma d'API, sélectionnez l'une des options suivantes afin de fournir le schéma d'API pour cet outil. Un schéma d'API décrit les opérations et les méthodes d'adresse d'API.
    • En ligne : pour un schéma de petite taille, vous pouvez entrer une chaîne contenant les opérations et les méthodes d'adresse d'API.
    • Choisir à partir d'Object Storage : pour un schéma volumineux ou un schéma comportant des mises à jour fréquentes, sélectionnez un compartiment et un bucket. Ensuite, sélectionnez le fichier contenant le schéma d'API.
  6. Pour Type d'authentification, sélectionnez l'une des options suivantes et effectuez la configuration de l'outil selon vos besoins.
    • Aucun : permet d'appeler des adresses d'API publiques ou privées qui ne nécessitent pas d'authentification. Lorsque cette option 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 des appels d'API. La clé d'API doit être stockée dans une clé secrète OCI Vault.
      • Emplacement de la clé : indiquez 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 de requête pour transmettre la clé en tant que paramètre de requête 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 de requête (par exemple, appid).
      • Sélectionner une clé secrète de coffre : dans le compartiment approprié, sélectionnez la clé secrète OCI Vault contenant la clé d'API.
    • De base : authentification de base HTTP à l'aide d'un nom utilisateur et d'un mot de passe. Les informations d'identification doivent être indiquées au format <your-username>:<your-password> et stockées dans une clé secrète OCI Vault.
      • Sélectionner une clé secrète de coffre : dans le compartiment approprié, sélectionnez la clé secrète OCI Vault qui contient les informations d'identification au format requis.
    • Porteur : authentification OAuth 2.0 à l'aide d'un jeton de support. Le jeton doit être stocké dans une clé secrète OCI Vault.
      • Sélectionner une clé secrète de coffre : dans le compartiment approprié, sélectionnez la clé secrète OCI Vault contenant 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 OCI Vault.
      • 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 OCI Vault contenant la clé secrète client pour l'application confidentielle.
      • URL de portée : entrez l'URL de portée qui définit un ensemble spécifique de ressources et d'opérations accessibles.
    • Principal de ressource OCI : uniquement pour appeler des API de service OCI telles qu'Object Storage, Compute et Networking (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 l'une des actions suivantes :

  • Si vous créez un agent, revenez à Création d'un agent dans des agents d'IA générative pour créer un autre outil ou une adresse d'agent.
  • Si vous avez ajouté l'outil à un agent existant, une fois l'outil actif, sur la page de détails de l'agent, sélectionnez Lancer la discussion pour discuter avec l'agent à l'aide de cet outil.
  • Si vous avez créé l'agent sans adresse d'agent, lorsque vous êtes prêt à l'utiliser, créez une adresse pour cet agent.
Remarque

Pour laisser un réviseur humain surveiller et modifier une réponse avant de l'envoyer à l'utilisateur, sélectionnez la fonctionnalité facultative Activer l'humain dans la boucle dans l'adresse d'agent.