27 Registre AI

AI Registry est le catalogue central d'agents et de serveurs MCP pour Oracle AI Data Platform. Il prend en charge les normes ouvertes, y compris MCP et A2A.

La plate-forme de données d'IA est l'endroit où les agents sont créés et déployés. Oracle Agent Hub est l'endroit où les utilisateurs professionnels leur parlent. Le registre AI est la couche entre eux. AI Registry rend un agent ou un outil détectable et utilisable en dehors de l'environnement dans lequel il a été intégré. Les agents et les outils doivent être inscrits dans le registre AI pour pouvoir être partagés dans le hub d'agent. Reportez-vous à Fonctionnement d'Enterprise AI dans Agent Hub dans Utilisation d'Oracle Agent Hub.

Vous pouvez inscrire les agents et outils suivants dans le registre AI de la plate-forme de données d'IA :

Type Description
Agent de plate-forme de données d'IA Agent créé et déployé dans AI Data Platform, dans un espace de travail auquel vous avez accès. Egalement appelé agent local dans le registre AI AI Data Platform.
Agent externe Agent hébergé en dehors de la plate-forme de données AI, ajouté par son URL de carte d'agent A2A.
Serveur MCP Un serveur MCP (Model Context Protocol) qui expose un ensemble d'outils que les agents peuvent appeler.

Dans le registre AI, vous pouvez gérer les agents AI, les serveurs MCP et les informations d'identification nécessaires pour utiliser les deux. Sur la page Registre AI, vous pouvez utiliser les onglets Agents, Serveurs MCP et Informations d'identification pour afficher les listes de chacun d'entre eux. Vous pouvez utiliser la barre de recherche pour filtrer les options visibles par nom ou par description. Dans l'onglet Agents, vous pouvez utiliser le menu déroulant Trier par pour trier les agents ajoutés récemment au registre.

Cliquez sur une carte d'agent pour afficher les détails de cet agent, en indiquant le créateur, la source, la version, une URL pour la carte d'agent et la version du protocole. Vous pouvez basculer entre la vue de détails et une vue JSON de la carte à l'aide des options dans le coin supérieur droit de la carte.

Avant d'enregistrer de nouveaux agents externes ou serveurs MCP, vous devez d'abord enregistrer leurs informations d'identification d'authentification dans l'onglet Informations d'identification. Vous pouvez ensuite inscrire de nouveaux agents et serveurs MCP en cliquant sur S'inscrire en haut à droite et en sélectionnant l'option appropriée. Les droits d'accès du registre AI sont gérés à partir de l'onglet Droits d'accès.

A propos des cartes d'agent

Les cartes d'agent sont la structure de métadonnées qui décrit un agent. Le registre AI les lit lors de l'inscription et vous les montre pour vérification avant de valider.

Pour plus d'informations, reportez-vous à la spécification de protocole A2A.

Les cartes d'agent contiennent les informations suivantes :
  • Nom, version et description.
  • URL de la carte d'agent, qui est l'endroit où la carte elle-même est publiée.
  • Version du protocole.
  • Modes d'entrée et de sortie. Par exemple, texte, texte/plain ou texte/html.
  • Fonctionnalités telles que Streaming.
  • Compétences, chacune avec son propre nom et sa propre description.
La carte correspond à ce contre quoi l'orchestration correspond. Lorsqu'un utilisateur pose une question dans Agent Hub sans sélectionner d'agent, le nom, la description, les compétences et les fonctionnalités de cette carte déterminent si votre agent est apparu. Une description vague est la raison la plus courante pour laquelle un agent n'est jamais sélectionné.

Créer des informations d'identification dans le registre AI

Vous pouvez enregistrer les informations d'identification nécessaires à l'authentification des objets du registre AI tels que les agents et les serveurs MCP.

  1. Sur la page d'accueil, cliquez sur Icône Registre AIRegistre AI.
  2. Cliquez sur l'onglet Informations d'identification, puis sur Créer des informations d'identification.
  3. Entrez le nom et la description des informations d'identification.
  4. Sélectionnez le type d'informations d'identification dans le menu déroulant.
  5. Sélectionnez le type d'octroi dans le menu déroulant.
  6. Entrez l'URL d'autorisation, l'URL de jeton d'accès, l'ID client, la clé secrète client et l'URL d'actualisation pour vos informations d'identification.
  7. Entrez le nom et la valeur de la portée. Au moins un nom et une valeur de portée sont requis. Ajoutez des noms et des valeurs de portée supplémentaires en cliquant sur Ajouter une portée.
  8. Copiez l'URL de réacheminement. Vous devez coller l'URL de redirection vers l'application confidentielle dans votre domaine d'identité. L'exemple suivant montre comment copier l'URL de redirection vers Oracle Cloud Infrastructure :
    1. Connectez-vous à la console OCI.
    2. Cliquez sur Identité et sécurité, puis sur Domaines et sur Applications intégrées.
    3. Sélectionnez l'application pour laquelle mettre à jour les URL de réacheminement.
    4. Cliquez sur l'onglet Configuration OAuth, puis sur Modifier la configuration OAuth.
    5. Appliquez les URL de réacheminement nécessaires, puis cliquez sur Soumettre.
  9. Cliquez sur Créer.

Inscription d'un agent local dans le registre AI

Vous pouvez inscrire des agents d'IA locaux à partir des espaces de travail Oracle AI Data Platform auxquels vous avez accès.

Les agents doivent être déployés dans AI Data Platform pour pouvoir être inscrits dans le registre AI. Reportez-vous à Déploiement d'agent.
  1. Sur la page d'accueil, cliquez sur Icône Registre AIRegistre AI.
  2. Cliquez sur Enregistrer, puis sur Agent.
  3. Cliquez sur Agent local.
  4. Dans le menu déroulant Espace de travail, sélectionnez l'espace de travail dans lequel se trouve l'agent local.
  5. Dans le menu déroulant Agent, sélectionnez l'agent à inscrire.
  6. Facultatif : positionnez le pointeur de la souris sur l'icône de la carte pour obtenir un aperçu de la carte d'agent.
  7. Cliquez sur Suivant.
  8. Vérifiez que les détails de l'agent sont corrects, puis cliquez sur Inscrire.

Inscrire un agent externe dans le registre AI

Vous pouvez inscrire des agents AI externes à partir de sources prises en charge dans votre registre AI. Ces agents doivent être conformes au protocole A2A.

Si votre agent externe nécessite une authentification, créez d'abord ces informations d'identification dans l'onglet Informations d'identification du registre AI.
  1. Sur la page d'accueil, cliquez sur Icône Registre AIRegistre AI.
  2. Cliquez sur Enregistrer, puis sur Agent.
  3. Cliquez sur Agent externe.
  4. Entrez l'URL de la carte d'agent.
  5. Facultatif : si votre adresse requiert des informations d'identification sécurisées, sélectionnez Exiger l'authentification, puis sélectionnez les informations d'identification dans le menu déroulant Informations d'identification.
  6. Cliquez sur Suivant.
  7. Facultatif : si vous avez sélectionné Exiger l'authentification, entrez les informations d'identification d'un compte habilité à l'agent dans la boîte de dialogue qui apparaît.
  8. Vérifiez l'exactitude des détails de l'agent, puis cliquez sur S'inscrire.

Inscription d'un serveur MCP dans le registre AI

Un serveur MCP expose un ensemble d'outils que les agents peuvent découvrir et appeler via une interface standard. L'enregistrement d'un outil dans le registre AI rend ces outils disponibles sur la plate-forme.

Remarques :

Si votre serveur MCP nécessite une authentification, vous devez d'abord créer les informations d'identification OAuth dans le registre AI. Les informations d'identification ne peuvent pas être ajoutées lors de l'inscription d'un serveur MCP.
  1. Sur la page d'accueil, cliquez sur Icône Registre AIRegistre AI.
  2. Cliquez sur Inscrire, puis sur Serveur MCP.
  3. Entrez l'URL de l'adresse de serveur MCP.
  4. Entrez un nom d'affichage et une description utiles. Les utilisateurs et agents les utiliseront pour identifier la finalité du serveur MCP.
  5. Dans le menu déroulant, sélectionnez la méthode Transport.
  6. Facultatif : si le serveur MCP requiert des informations d'identification sécurisées, sélectionnez Exiger l'authentification. Sélectionnez les informations d'identification dans le menu déroulant Informations d'identification.
  7. Cliquez sur Continuer.
  8. Consultez la liste des outils inclus pour le serveur MCP sélectionné. Sélectionnez les outils à inclure individuellement ou cliquez sur Tout sélectionner pour inclure tous les outils répertoriés.
  9. Cliquez sur Inscrire.