Utiliser le service de l'agent Foundry dans Visual Studio Code (aperçu)

Une fois que vous avez démarré avec l’extension Microsoft Foundry pour Visual Studio Code, utilisez Foundry Agent Service pour générer des agents. Les agents sont des microservices qui :

• Répondez aux questions à l’aide de leurs données d’apprentissage ou recherchez d’autres sources avec la génération augmentée par récupération (RAG).
• Effectuer des actions spécifiques.
• Automatisez les flux de travail complets.

Les agents combinent des modèles IA avec des outils permettant d’accéder à vos données et d’interagir avec celles-ci.

Les développeurs de foundry peuvent rester productifs en développant, en testant et en déployant des agents dans l’environnement familier de Visual Studio Code (VS Code).

Créer et modifier un agent Azure AI dans la vue concepteur

Procédez comme suit pour créer un agent Azure AI :

1. Connectez-vous à vos ressources Azure.

2. Définissez votre projet par défaut.

3. Déployez un modèle à utiliser avec votre agent.

4. Dans la vue Extension Foundry , recherchez la section Ressources .

5. Sélectionnez l’icône plus (+) en regard de la sous-section Agents pour créer un agent IA.

   

Interagir avec votre agent dans le concepteur

Une fois que vous avez choisi l'emplacement d'enregistrement, le fichier .yaml de l'agent et la vue du concepteur s'ouvrent afin que vous puissiez modifier votre agent IA. Effectuez les tâches suivantes dans le concepteur d’agents :

1. Dans l’invite, entrez un nom pour votre agent.

2. Dans la liste déroulante, sélectionnez le nom de votre déploiement de modèle. Le nom du déploiement est ce que vous avez choisi lorsque vous avez déployé un modèle existant.

3. L’extension génère la valeur ID . Configurez les champs suivants :

   • Ajoutez une description pour votre agent.
   • Définissez les instructions système.
   • Configurez des outils pour l’utilisation de l’agent.

   

4. Pour enregistrer le fichier .yaml, sélectionnez Fichier>Enregistrer dans la barre de menus VS Code.

Explorer la définition .yaml de l’agent Azure AI

Le fichier .yaml de votre assistant IA a été ouvert en même temps que le concepteur. Ce fichier contient les détails et les informations d’installation de votre agent. Il est similaire à l’exemple de fichier .yaml suivant :

# yaml-language-server: $schema=https://aka.ms/ai-foundry-vsc/agent/1.0.0
version: 1.0.0
name: my-agent
description: Description of the agent
id: ''
metadata:
  authors:
    - author1
    - author2
  tags:
    - tag1
    - tag2
model:
  id: 'gpt-4o-1'
  options:
    temperature: 1
    top_p: 1
instructions: Instructions for the agent
tools: []

Ajouter des outils à l’agent Azure AI

Le service d’agent dispose de l’ensemble d’outils suivant que vous pouvez utiliser pour interagir avec vos sources de données. Ces outils sont disponibles dans l’extension Foundry pour Visual Studio Code.

• Ancrage avec la Recherche Bing
• Recherche de fichiers
• Interpréteur de code
• Outils spécifiés OpenAPI
• Protocole de Contexte de Modèle (MCP)

Pour plus d’informations sur l’utilisation des outils MCP, consultez Work with Agent Service and MCP Server Tools in Visual Studio Code (préversion).

Ajouter un outil à l’agent IA

1. Dans le concepteur, dans le coin supérieur droit de la section TOOL , sélectionnez Ajouter un outil. Dans la liste déroulante, sélectionnez l’outil que vous souhaitez ajouter.

   

2. Le concepteur affiche le volet approprié pour configurer l’outil, comme illustré dans les images suivantes :

   • Enracinement avec la recherche Bing

     

   • Recherche de fichiers :

     

   • Interpréteur de code :

     

   • Outils spécifiés OpenAPI 3.0 :

     

3. Après avoir entré les informations requises, sélectionnez Créer et connecter, Charger et enregistrer ou Créer un outil. Le bouton varie en fonction du volet.

Lorsque vous ajoutez un outil, vous pouvez également ajouter toutes les nouvelles ressources dont elle a besoin. Par exemple, si vous ajoutez un outil de recherche de fichiers, vous pouvez utiliser une ressource de magasin de vecteurs existante ou créer une nouvelle ressource pour votre magasin de vecteurs pour héberger vos fichiers chargés.

Créer un agent Azure AI sur Foundry

Créez votre agent directement sur Foundry en procédant comme suit :

1. Dans le concepteur, sélectionnez le bouton Créer un agent sur Foundry .

   

2. Dans VS Code, actualisez la vue Ressources Azure. L’agent déployé apparaît dans la sous-section Agents .

   

Afficher les détails de l’agent IA déployé

La sélection de l’agent déployé ouvre le volet PRÉFÉRENCES de l’AGENT en mode affichage uniquement. Vous pouvez:

• Sélectionnez le bouton Modifier l’agent pour afficher le concepteur d’agents et la définition .yaml de l’agent pour modification.
• Sélectionnez le bouton Ouvrir le fichier de code pour créer un exemple de fichier de code qui utilise l’agent.
• Sélectionnez le bouton Ouvrir le terrain de jeu pour ouvrir le terrain de jeu de l’agent.

Modifier et mettre à jour l’agent IA déployé

1. Dans le volet PRÉFÉRENCES de l’AGENT , sélectionnez le bouton Modifier l’agent . Le concepteur d’agents s’ouvre avec le fichier .yaml de l’agent.

2. Modifiez la configuration de l’agent, comme le modèle, les outils et les instructions.

3. Une fois la modification terminée, sélectionnez le bouton Mettre à jour l’agent sur Foundry pour enregistrer vos modifications.

Créer un exemple de fichier de code

1. Cliquez avec le bouton droit sur votre agent déployé, puis sélectionnez l’option Ouvrir le fichier de code . Ou, dans le volet PRÉFÉRENCES de l’AGENT , sélectionnez le bouton Ouvrir le fichier de code .

   

2. Dans la liste déroulante Choisir votre sdk préféré , sélectionnez votre KIT SDK préféré pour le fichier de code de l’agent, puis sélectionnez la clé Entrée .

   

3. Dans la liste déroulante Choisir une langue , sélectionnez votre langue préférée pour le fichier de code de l’agent, puis sélectionnez la clé Entrée .

   

4. Dans la liste déroulante Choisir une méthode d’authentification , sélectionnez votre méthode d’authentification préférée pour le fichier de code de l’agent, puis sélectionnez la clé Entrée .

   

Explorer l’exemple de fichier de code

L’exemple de fichier de code Python suivant illustre un appel de base pour interagir avec l’agent via l’API Foundry Projects.

Interagir avec les agents à l’aide du terrain de jeu de l’agent

1. Cliquez avec le bouton droit sur votre agent déployé, puis sélectionnez l’option Open Playground .

   Vous pouvez également sélectionner le lien Agent Playground dans la sous-section Outils , puis sélectionner votre agent dans la liste déroulante.

   Cette étape ouvre le volet Agent Playground et démarre un thread avec votre agent pour pouvoir envoyer des messages.

   

2. Entrez votre commande et affichez les résultats.

   Cet exemple utilise Bing Grounding pour illustrer une recherche web d’informations. L’agent utilise le modèle et les outils que vous avez configurés dans le concepteur d’agents. La source des informations apparaît dans la section pour les annotations de l’agent.

   

Explorer les threads

La sous-section Threads affiche les threads créés pendant une exécution avec votre agent. Dans la vue Ressources Azure , développez la sous-section Threads pour afficher la liste.

Gardez ces termes à l’esprit lorsque vous explorez les threads :

• Un thread est une session de conversation entre un agent et un utilisateur. Les threads stockent les messages et gèrent automatiquement la troncation pour ajuster le contenu dans le contexte d’un modèle.

• Un message est une interaction unique entre l’agent et l’utilisateur. Les messages peuvent contenir du texte, des images et d’autres fichiers. Les messages sont stockés sous forme de liste sur le thread.

• Une exécution correspond à un lancement unique d’un agent. Chaque exécution peut avoir plusieurs threads, et chaque thread peut avoir plusieurs messages. L’agent utilise sa configuration et les messages d’un thread pour effectuer des tâches en appelant des modèles et des outils. Dans le cadre d’une exécution, l’agent ajoute des messages au thread.

Afficher les détails du thread

Pour afficher le volet DÉTAILS DU THREAD , sélectionnez un thread.

Afficher les détails de l’exécution

Pour afficher les informations d’exécution dans un fichier JSON, sélectionnez le bouton Afficher les informations d’exécution dans le volet DÉTAILS DU THREAD . La capture d’écran suivante montre un exemple de fichier JSON.

Nettoyer les ressources

Les ressources Azure que vous avez créées dans cet article sont facturées à votre abonnement Azure. Si vous pensez ne plus avoir besoin de ces ressources, supprimez-les pour éviter des frais supplémentaires.

Supprimer vos agents

1. Dans VS Code, actualisez la vue Ressources Azure. Développez la sous-section Agents pour afficher la liste des agents déployés.
2. Cliquez avec le bouton droit sur l’agent déployé à supprimer, puis sélectionnez Supprimer.

Supprimer vos modèles

1. Dans VS Code, actualisez la vue Ressources Azure. Développez la sous-section Modèles pour afficher la liste des modèles déployés.

2. Cliquez avec le bouton droit sur le modèle déployé à supprimer, puis sélectionnez Supprimer.

   

Supprimer vos outils connectés

1. Ouvrez le portail Azure.

2. Sélectionnez le groupe de ressources Azure qui contient l’outil.

3. Sélectionnez le bouton Supprimer .

Contenu connexe

• Découvrez les outils que vous pouvez utiliser avec des agents Azure AI, tels que la recherche de fichiers ou l’interpréteur de code.