Connectez-vous à Foundry IQ depuis un agent

Foundry IQ connecte votre agent à une base de connaissances intégrée à Azure AI Foundry. Une base de connaissances Foundry IQ regroupe une ou plusieurs sources de données d’entreprise ainsi que des paramètres de recherche et de pertinence en un seul actif réutilisable. Lorsque vous vous connectez à une base de connaissances déjà construite et réglée par quelqu’un dans votre organisation, votre agent peut répondre à des questions sur ce contenu sans que vous ayez à recréer la configuration dans Copilot Studio.

Foundry IQ est ajouté à votre agent comme outil depuis le bouton Outils du panneau des composants.

Note

Les fonctionnalités de cet article sont utilisées par des agents ou des flux de travail alimentés par le harnais GitHub Copilot.

La facturation basée sur l’utilisation s’applique à l’utilisation, à la construction, aux tests et à l’évaluation des agents. Ces actions peuvent consommer des crédits Copilot. En savoir plus dans Gérer les coûts pour les agents alimentés par le harnais GitHub Copilot.

Vous vous connectez à Foundry IQ lorsque :

  • Une équipe de votre organisation a déjà construit et ajusté une base de connaissances sur Azure AI Foundry qui correspond au domaine de votre agent.
  • Vous voulez que votre agent utilise la configuration de récupération de cette équipe au lieu de modéliser vous-même les connaissances dans Copilot Studio.

Prerequisites

  • Un agent créé avec le harnais GitHub Copilot. En savoir plus dans Créer un agent.
  • Accès à au moins une base de connaissances Foundry IQ, accordée dans Azure AI Foundry. Seules les bases de connaissances auxquelles vous avez accès apparaissent dans le sélecteur.

Note

Votre agent ne peut avoir qu’une seule connexion Foundry IQ par agent.

Créer une nouvelle connexion IQ Foundry

  1. Ouvrez votre agent dans Copilot Studio.
  2. Cliquez sur l’onglet Créer.
  3. Dans le panneau des composants, sélectionnez Outils pour ouvrir la boîte de dialogue Ajouter un outil .
  4. Sélectionnez Foundry IQ.
  5. Cliquez sur Créer une connexion.
  6. Sélectionnez le type d’authentification : clé API, Authentification du certificat client, principal de service (application Microsoft Entra ID) ou Microsoft Entra ID Intégré.
    1. Pour la clé API, saisissez le point de terminaison et la clé API du service de recherche Foundry IQ.
    2. Pour l’authentification par certificat client, saisissez le point de terminaison du service de recherche Foundry IQ, l’ID de locataire, l’ID client, le secret du certificat client et le mot de passe du certificat.
    3. Pour le principal du service, saisissez le point de terminaison du service de recherche Foundry IQ, l’ID du locataire, l’ID du client et le secret du client.
    4. Pour Microsoft Entra ID Integrated, entrez le point de terminaison du service de recherche Foundry IQ.
  7. Cliquez sur Créer.
  8. La connexion est créée, puis sélectionnez Suivant.
  9. Sélectionnez une base de connaissances dans la liste, puis sélectionnez Ajouter à l’agent.
  10. Cliquez sur Enregistrer.
  11. Après avoir enregistré, la section Outils de l’onglet Build affiche la connexion Foundry IQ comme un outil connecté.
  12. Sélectionnez la nouvelle connexion Foundry IQ ajoutée et mettez à jour le nom et la description. La description doit être aussi détaillée que possible, car elle facilite l’orchestration.
  13. Cliquez sur Enregistrer.

Testez vos connaissances sur la source de connaissances Foundry IQ

  1. Sélectionnez l’onglet Aperçu .
  2. Envoie une question de test à laquelle la base de connaissances devrait pouvoir répondre.
  3. Ouvrez la trace d’activité pour la réponse.

La trace d’activité montre que Foundry IQ a géré l’étape de récupération et liste les éléments qu’il a retournés à votre agent. Votre agent utilise ces éléments pour rédiger sa réponse. Si la trace n’affiche pas d’étape de récupération IQ Foundry, confirmez que la base de connaissances est sélectionnée dans l’onglet Build et que la question est dans le champ des données couvertes par la base.

Tip

Si les résultats ne sont pas ceux auxquels vous vous attendez, ajustez la base de connaissances elle-même dans Azure AI Foundry, pas dans Copilot Studio. Travaillez avec le propriétaire de la base de connaissances pour ajuster les sources, les instructions de recherche ou le classement.

Supprimer une connexion Foundry IQ

  1. Dans l’onglet Build , sélectionnez Outils.
  2. Dans le panneau des composants, sélectionnez la base de connaissances Foundry IQ connectée et sélectionnez le x pour supprimer la connexion.

Note

Supprimer une connexion dans Copilot Studio ne supprime ni ne modifie la base de connaissances dans Azure AI Foundry.

  • Last updated on