Quand utiliser les plugins API
En utilisant des plugins API, vous permettez à un agent déclaratif de communiquer avec des API pour lire et modifier des données externes. Découvrez comment décider quand utiliser des plugins API pour étendre votre agent déclaratif.
Critères de décision
Les plugins API vous offrent de puissantes capacités d’intégration pour vos agents déclaratifs. Les critères suivants vous aident à déterminer si les plugins API conviennent à votre scénario.
Données au-delà du modèle de base
La première chose à comprendre est 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, comme vos bases de données internes, vous devez l’étendre avec, par exemple, un plugin API.
Structure des données
Ensuite, il faut comprendre la structure des données que l’agent doit consulter. Les données sont-elles structurées, comme des fiches clients ou des commandes, ou non structurées comme un document ou un rapport ? Si les données sont structurées, elles conviennent bien à l’utilisation d’un plugin API. Si elles sont non structurées, avez-vous un index de recherche et une API que l’agent pourrait utiliser ? Sinon, vous pourriez envisager d’utiliser un connecteur Copilot pour ingérer les données dans Microsoft 365 et bénéficier de ses capacités de recherche.
Accès aux données
Enfin, la décision d’utiliser un plugin API et l’effort requis dépendent de la capacité du plugin à accéder aux données. Avez-vous une API à laquelle l’agent peut se connecter ? Disposez-vous d’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 ne pourrait pas formuler ?
Application des critères
Les plugins API fonctionnent mieux lorsque vous devez connecter un agent déclaratif à des données structurées et fréquemment mises à jour, en dehors de son modèle de base. Comme cette décision comporte des nuances, réfléchissons à la manière d’appliquer ces critères à notre scénario d’exemple.
- L’agent a-t-il besoin d’accéder à des 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. Elles sont stockées dans une base de données et exposées via une API, ce qui rend l’utilisation d’un plugin API pertinente pour donner accès à ces informations.
- Les informations sont-elles structurées ? Oui. Les données sur les réparations sont structurées et exposées via une API. Comme elles ne nécessitent pas de traitement supplémentaire, elles conviennent à l’utilisation d’un plugin API.
- Les informations exposées via l’API sont-elles accessibles sur Internet ? Oui. Les données sur les réparations sont exposées via une API accessible sur Internet et sécurisée par une clé API, ce qui permet à l’agent d’interagir avec elle en toute sécurité.
Un agent déclaratif avec un plugin API semble être une bonne solution pour notre scénario. Il répond à tous nos besoins et offre même la possibilité d’étendre l’assistant à l’avenir pour permettre aux utilisateurs de modifier les informations sur les réparations.
Résumé des recommandations
Le diagramme de flux suivant résume les principales questions à se poser lorsque vous envisagez d’étendre votre agent déclaratif avec un plugin d’API.
