Quand utiliser les plug-ins d’API
À l’aide de plug-ins d’API, vous autorisez l’agent déclaratif à communiquer avec les API pour lire et modifier des données externes. Découvrez comment décider quand utiliser les plug-ins d’API pour étendre votre agent déclaratif.
Critères de décision
Les plug-ins d’API vous offrent de puissantes fonctionnalités d’intégration pour vos agents déclaratifs. Les critères suivants vous aident à déterminer si les plug-ins d’API conviennent à votre scénario.
Données au-delà du modèle de base
La première chose que vous devez comprendre est de savoir si l’agent peut répondre à vos besoins en utilisant uniquement les informations de son modèle de base. S’il a besoin d’accéder à des informations supplémentaires, telles que vos bases de données internes, vous devez les étendre avec, par exemple, un plug-in d’API.
Forme de données
La prochaine chose que vous devez comprendre est la forme des données auxquelles l’agent doit accéder. Les données sont-elles structurées, comme les enregistrements ou les commandes des clients, ou sont-elles non structurées comme un document ou un rapport ? Si les données sont structurées, il s’agit d’une bonne correspondance pour une utilisation avec un plug-in d’API. S’il n’est pas structuré, disposez-vous d’un index de recherche et d’une API que l’agent peut utiliser ? Sinon, vous pouvez envisager d’utiliser un connecteur Copilot pour ingérer les données dans Microsoft 365 et tirer parti de ses fonctionnalités de recherche.
Accès aux données
La dernière chose qui détermine la décision d’utiliser un plug-in d’API et la quantité d’efforts impliqués est la capacité du plug-in à accéder aux données. Disposez-vous d’une API à laquelle l’agent peut se connecter ? Avez-vous une spécification OpenAPI qui décrit l’API ? L’API utilise-t-elle un mécanisme d’authentification que l’agent peut gérer ? L’API est-elle simple à comprendre ou à utiliser, ou utilise-t-elle des requêtes complexes qu’un modèle de langage n’a pas pu effectuer ?
Appliquer les critères
Les plug-ins d’API fonctionnent mieux lorsque vous devez connecter un agent déclaratif à des données structurées et qui changent fréquemment en dehors de son modèle de base. Étant donné qu’il existe des nuances dans cette décision, réfléchissons à la façon d’appliquer ces critères à notre exemple de scénario.
- L’agent a-t-il besoin d’accéder aux données au-delà du modèle de base ? Oui. Les informations sur les réparations ne font pas partie du modèle de base de l’agent. Au lieu de cela, les informations sont stockées dans une base de données et exposées via une API, c’est pourquoi l’utilisation d’un plug-in d’API est un bon moyen de donner à l’agent l’accès à ces informations.
- L’information est-elle structurée ? Oui. Les informations de réparation sont des données structurées exposées via une API. Étant donné qu’il n’a pas besoin de plus de traitement, il peut être utilisé par un plug-in d’API.
- Les informations exposées via une API sont-elles accessibles sur Internet ? Oui. Les informations de réparation sont exposées via une API. L’API est accessible sur Internet et sécurisée à l’aide d’une clé API, ce qui signifie que l’agent peut interagir en toute sécurité avec elle.
Un agent déclaratif avec un plug-in d’API semble être une bonne solution pour notre scénario. Il répond à toutes nos exigences et nous offre même la possibilité d’étendre la assistant à l’avenir pour permettre aux utilisateurs de modifier les informations sur les réparations.
Résumé de l’aide
L’organigramme suivant résume les questions clés à poser lorsque vous envisagez d’étendre votre agent déclaratif avec un plug-in d’API.
