Cette page s'applique à Apigee et à Apigee hybrid.
Cet article explique comment créer des extensions Vertex AI dans le hub d'API.
Qu'est-ce qu'une extension Vertex AI ?
Les extensions Vertex AI permettent aux LLM de se connecter à des données et des actions réelles via des API. Les extensions traitent les requêtes utilisateur et communiquent avec de grands modèles de langage (LLM) pour exécuter des opérations pour le compte d'une application, telle qu'une application de chat.
Par exemple, supposons que vous créiez une extension Vertex AI pour une API de location de voiture, et que cette extension soit associée à une application de chat. Lorsqu'un utilisateur demande à l'application de louer une voiture, l'IA générative comprend le contexte de la question et appelle l'API d'extension permettant de louer une voiture.
Pour en savoir plus sur les extensions Vertex AI, consultez la présentation de l'IA générative sur Vertex AI.
Le hub d'API simplifie la création d'extensions Vertex AI
Le hub d'API simplifie le processus de création d'une extension Vertex AI en utilisant les métadonnées existantes du hub d'API. Les données clés utilisées par le hub d'API pour créer une extension sont une spécification d'API et un déploiement, qui sont déjà validés par le hub d'API. La spécification fournit les opérations de l'API à l'extension, et le déploiement fournit le point de terminaison du serveur de l'API.
Créer une extension Vertex AI
Pour créer une extension Vertex AI dans l'API Hub :
Console
Pour créer une extension :
Dans la console Google Cloud, accédez à la page API de l'API Hub Apigee.
Accéder au hub d'API- Recherchez l'API à laquelle vous souhaitez ajouter une extension. Utilisez l'option Filtrer pour spécifier des mots clés afin de filtrer la liste des API. Si besoin, utilisez l'option Rechercher pour trouver une API.
- Cliquez sur une API pour afficher sa page d'informations détaillées.
- Cliquez sur Créer une extension Vertex.
- Spécifiez les détails de l'extension dans le formulaire Créer une extension Vertex :
- Nom de l'extension : (obligatoire) vous devez indiquer un nom d'extension.
- Description (obligatoire) : ajoutez une description de l'extension.
- Version : (obligatoire) sélectionnez une version d'API.
- Fichier de spécification : (obligatoire) si une spécification est associée à la version de l'API, elle est automatiquement renseignée dans ce champ. Consultez la section Gérer les spécifications d'API.
- Déploiement : (obligatoire) Si un déploiement est associé à la version de l'API, il est automatiquement renseigné dans ce champ. Consultez la section Gérer les déploiements.
- Cliquez sur Créer une extension. Si vous ajoutez l'extension à la version par défaut, elle apparaît dans la section Extensions de la page d'informations de l'API. Si vous avez ajouté l'extension à une autre version, vous devez consulter la page d'informations de la version pour voir l'extension répertoriée.
Afficher la liste des extensions Vertex AI
Cette section explique comment lister les extensions de Vertex.
Console
Pour afficher toutes les extensions associées à une API enregistrée dans la console, procédez comme suit :
Dans la console Google Cloud, accédez à la page API Hub.
Accéder au hub d'API- Cliquez sur API.
- Localisez l'API que vous souhaitez inspecter. Utilisez l'option Filtrer pour spécifier des mots clés afin de filtrer la liste des API. Si besoin, utilisez l'option Rechercher pour trouver une API.
- Sélectionnez une API.
- Toutes les extensions ajoutées à la version par défaut sont listées dans la section "Extensions" de la page "Détails de l'API". Si une extension a été ajoutée à une autre version, vous devez consulter la page des informations de la version pour voir l'extension répertoriée.
Obtenir les détails de l'extension Vertex AI
Cette section explique comment obtenir des informations détaillées sur une extension Vertex AI.
Console
Pour afficher les détails de l'extension Vertex AI dans la console, procédez comme suit :
Dans la console Google Cloud, accédez à la page API Hub.
Accéder au hub d'API- Cliquez sur API.
- Localisez l'API que vous souhaitez inspecter. Utilisez l'option Filtrer pour spécifier des mots clés afin de filtrer la liste des API. Si besoin, utilisez l'option Rechercher pour trouver une API.
- Sélectionnez une API.
- Toutes les extensions ajoutées à la version par défaut sont répertoriées dans la section "Extensions" de la page d'informations de l'API. Si une extension a été ajoutée à une autre version, vous devez consulter la page des informations de la version pour voir l'extension répertoriée. Dans le tableau Extensions Vertex, cliquez sur une extension pour afficher ses informations détaillées.
Supprimer une extension Vertex AI
Cette section explique comment supprimer une extension Vertex.
Console
Pour supprimer une extension :
Dans la console Google Cloud, accédez à la page API Hub.
Accéder au hub d'API- Cliquez sur API.
- Localisez l'API qui inclut l'extension que vous souhaitez supprimer. Utilisez l'option Filtrer pour spécifier des mots clés afin de filtrer la liste des API. Si besoin, utilisez l'option Rechercher pour trouver une API.
- Sélectionnez une API.
- Recherchez l'extension à supprimer. Toutes les extensions ajoutées à la version par défaut sont répertoriées dans la section "Extensions" de la page des détails de l'API. Si une extension a été ajoutée à une autre version, vous devez consulter la page des informations de la version pour voir l'extension répertoriée.
- Dans le menu Actions (à droite de la ligne contenant l'extension), cliquez sur Supprimer.