{"id":9206,"date":"2025-10-16T09:09:09","date_gmt":"2025-10-16T09:09:09","guid":{"rendered":"https:\/\/techhub.saworks.io\/?post_type=docs&p=9206"},"modified":"2025-11-17T16:54:04","modified_gmt":"2025-11-17T16:54:04","slug":"quand-utiliser-les-plugins-api","status":"publish","type":"docs","link":"https:\/\/techhub.saworks.io\/fr\/docs\/tutoriel-agent-debutant\/etendre-les-agents-declaratifs-pour-microsoft-365-copilot-avec-des-plugins-api-en-utilisant-visual-studio-code\/quand-utiliser-les-plugins-api\/","title":{"rendered":"Quand utiliser les plugins API"},"content":{"rendered":"\n
\n

En utilisant des plugins API, vous permettez \u00e0 un agent d\u00e9claratif de communiquer avec des API pour lire et modifier des donn\u00e9es externes. D\u00e9couvrez comment d\u00e9cider quand utiliser des plugins API pour \u00e9tendre votre agent d\u00e9claratif.<\/p>\n\n\n\n

<\/div>\n\n\n\n

Crit\u00e8res de d\u00e9cision<\/strong><\/h3>\n\n\n\n

Les plugins API vous offrent de puissantes capacit\u00e9s d\u2019int\u00e9gration pour vos agents d\u00e9claratifs. Les crit\u00e8res suivants vous aident \u00e0 d\u00e9terminer si les plugins API conviennent \u00e0 votre sc\u00e9nario.<\/p>\n\n\n\n

<\/div>\n\n\n\n

Donn\u00e9es au-del\u00e0 du mod\u00e8le de base<\/strong><\/h4>\n\n\n\n

La premi\u00e8re chose \u00e0 comprendre est si l\u2019agent peut r\u00e9pondre \u00e0 vos besoins en utilisant uniquement les informations de son mod\u00e8le de base. S\u2019il a besoin d\u2019acc\u00e9der \u00e0 des informations suppl\u00e9mentaires, comme vos bases de donn\u00e9es internes, vous devez l\u2019\u00e9tendre avec, par exemple, un plugin API.<\/p>\n\n\n\n

<\/div>\n\n\n\n

Structure des donn\u00e9es<\/strong><\/h4>\n\n\n\n

Ensuite, il faut comprendre la structure des donn\u00e9es que l\u2019agent doit consulter. Les donn\u00e9es sont-elles structur\u00e9es, comme des fiches clients ou des commandes, ou non structur\u00e9es comme un document ou un rapport ? Si les donn\u00e9es sont structur\u00e9es, elles conviennent bien \u00e0 l\u2019utilisation d\u2019un plugin API. Si elles sont non structur\u00e9es, avez-vous un index de recherche et une API que l\u2019agent pourrait utiliser ? Sinon, vous pourriez envisager d\u2019utiliser un connecteur Copilot pour ing\u00e9rer les donn\u00e9es dans Microsoft 365 et b\u00e9n\u00e9ficier de ses capacit\u00e9s de recherche.<\/p>\n\n\n\n

<\/div>\n\n\n\n

Acc\u00e8s aux donn\u00e9es<\/strong><\/h4>\n\n\n\n

Enfin, la d\u00e9cision d\u2019utiliser un plugin API et l\u2019effort requis d\u00e9pendent de la capacit\u00e9 du plugin \u00e0 acc\u00e9der aux donn\u00e9es. Avez-vous une API \u00e0 laquelle l\u2019agent peut se connecter ? Disposez-vous d\u2019une sp\u00e9cification OpenAPI qui d\u00e9crit l\u2019API ? L\u2019API utilise-t-elle un m\u00e9canisme d\u2019authentification que l\u2019agent peut g\u00e9rer ? L\u2019API est-elle simple \u00e0 comprendre ou utiliser, ou utilise-t-elle des requ\u00eates complexes qu\u2019un mod\u00e8le de langage ne pourrait pas formuler ?<\/p>\n\n\n\n

<\/div>\n\n\n\n

Application des crit\u00e8res<\/strong><\/h3>\n\n\n\n

Les plugins API fonctionnent mieux lorsque vous devez connecter un agent d\u00e9claratif \u00e0 des donn\u00e9es structur\u00e9es et fr\u00e9quemment mises \u00e0 jour, en dehors de son mod\u00e8le de base. Comme cette d\u00e9cision comporte des nuances, r\u00e9fl\u00e9chissons \u00e0 la mani\u00e8re d\u2019appliquer ces crit\u00e8res \u00e0 notre sc\u00e9nario d\u2019exemple.<\/p>\n\n\n\n

    \n
  • L\u2019agent a-t-il besoin d\u2019acc\u00e9der \u00e0 des donn\u00e9es au-del\u00e0 du mod\u00e8le de base ?<\/strong> Oui. Les informations sur les r\u00e9parations ne font pas partie du mod\u00e8le de base de l\u2019agent. Elles sont stock\u00e9es dans une base de donn\u00e9es et expos\u00e9es via une API, ce qui rend l\u2019utilisation d\u2019un plugin API pertinente pour donner acc\u00e8s \u00e0 ces informations.<\/li>\n\n\n\n
  • Les informations sont-elles structur\u00e9es ?<\/strong> Oui. Les donn\u00e9es sur les r\u00e9parations sont structur\u00e9es et expos\u00e9es via une API. Comme elles ne n\u00e9cessitent pas de traitement suppl\u00e9mentaire, elles conviennent \u00e0 l\u2019utilisation d\u2019un plugin API.<\/li>\n\n\n\n
  • Les informations expos\u00e9es via l\u2019API sont-elles accessibles sur Internet ?<\/strong> Oui. Les donn\u00e9es sur les r\u00e9parations sont expos\u00e9es via une API accessible sur Internet et s\u00e9curis\u00e9e par une cl\u00e9 API, ce qui permet \u00e0 l\u2019agent d\u2019interagir avec elle en toute s\u00e9curit\u00e9.<\/li>\n<\/ul>\n\n\n\n

    Un agent d\u00e9claratif avec un plugin API semble \u00eatre une bonne solution pour notre sc\u00e9nario. Il r\u00e9pond \u00e0 tous nos besoins et offre m\u00eame la possibilit\u00e9 d\u2019\u00e9tendre l\u2019assistant \u00e0 l\u2019avenir pour permettre aux utilisateurs de modifier les informations sur les r\u00e9parations.<\/p>\n\n\n\n

    <\/div>\n\n\n\n
    \"\"<\/figure>\n\n\n\n
    <\/div>\n\n\n\n

    R\u00e9sum\u00e9 des recommandations<\/strong><\/h3>\n\n\n\n


    Le diagramme de flux suivant r\u00e9sume les principales questions \u00e0 se poser lorsque vous envisagez d’\u00e9tendre votre agent d\u00e9claratif avec un plugin d’API.<\/p>\n\n\n\n

    <\/div>\n\n\n\n
    \"\"<\/figure>\n\n\n\n
    <\/div>\n\n\n\n

    Unit\u00e9 suivante : \u00c9valuation du module<\/strong><\/h3>\n<\/div>\n","protected":false},"excerpt":{"rendered":"

    En utilisant des plugins API, vous permettez \u00e0 un agent d\u00e9claratif de communiquer avec des API pour lire et modifier des donn\u00e9es externes. […]<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":9185,"menu_order":21,"comment_status":"closed","ping_status":"closed","template":"","doc_tag":[],"doc_badge":[],"class_list":["post-9206","docs","type-docs","status-publish","hentry"],"author_avatar":"https:\/\/secure.gravatar.com\/avatar\/6a70e7c73db9f245e650948d09d74f61?s=96&d=mm&r=g","author_name":"Annick N'dri","_links":{"self":[{"href":"https:\/\/techhub.saworks.io\/fr\/wp-json\/wp\/v2\/docs\/9206"}],"collection":[{"href":"https:\/\/techhub.saworks.io\/fr\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/techhub.saworks.io\/fr\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/techhub.saworks.io\/fr\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/techhub.saworks.io\/fr\/wp-json\/wp\/v2\/comments?post=9206"}],"version-history":[{"count":0,"href":"https:\/\/techhub.saworks.io\/fr\/wp-json\/wp\/v2\/docs\/9206\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/techhub.saworks.io\/fr\/wp-json\/wp\/v2\/docs\/9185"}],"wp:attachment":[{"href":"https:\/\/techhub.saworks.io\/fr\/wp-json\/wp\/v2\/media?parent=9206"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/techhub.saworks.io\/fr\/wp-json\/wp\/v2\/doc_tag?post=9206"},{"taxonomy":"doc_badge","embeddable":true,"href":"https:\/\/techhub.saworks.io\/fr\/wp-json\/wp\/v2\/doc_badge?post=9206"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}