Invoquer l’agent

Appelez un agent Microsoft Azure AI Foundry basé sur l'API de réponses dans un processus agentique Maestro.

Description

Cette activité permet l’utilisation d’agents Microsoft Azure AI Foundry créés sur l’API Réponses en tant que participants dans un processus automatisé orchestré par Maestro.

L'agent de Foundry est apparu

Azure AI Foundry expose deux interfaces d'agent distinctes sur le même point de terminaison du projet:

• Assistants (classiques): créés via l'API /assistants . Utilisez pour ceux-ci l’activité Exécuter le fil de discussion .
• Agents (portail Foundry): créés dans le portail Azure AI Foundry et invoqués via l’API de réponses. Utilisez Invoke Agent pour cela.

Remarque :

Seuls les agents de type invite et hébergé sont vérifiés pour travailler avec cette activité. Les agents de type workflow ou externe n’ont pas été validés et ne sont pas confirmés.

Comment utiliser l’activité

Pour utiliser cette activité dans un processus agentique Maestro, procédez comme suit :

1. Ajoutez un élément de tâche de service à la zone de dessin et ouvrez le panneau Propriétés de la tâche.

2. Dans la section Implementation , de la liste déroulante Action , sélectionnez Start and wait for external agent.

3. Sélectionnez le connecteur Microsoft Azure AI Foundry.

4. Sélectionnez une connexion existante ou créez-en une nouvelle. Pour plus d’informations, consultez la section Authentification Microsoft Azure AI Foundry.

5. Dans Activité, sélectionnez Invoquer l'agent.

6. À partir de l’option Agent, sélectionnez un agent dans la liste des agents de votre projet Azure AI Foundry. Chaque entrée affiche le type de l'agent à côté de son nom, par exemple ah-vo-script-agent (hosted).

7. Dans Message, saisissez la requête à envoyer à l'agent.

8. Connectez l'événement de début à la tâche de service et la tâche de service à un nœud d'événement de fin dans le canevas.

9. Sélectionnez Debug pour exécuter ce processus.

   L’activité s’exécute toujours de manière asynchrone: Integration Service interroge la réponse de l’agent et reprend l’étape Maestro une fois l’exécution terminée.

Sortie

Paramètre	Description
Identificateur de réponse	Identificateur unique de la réponse de l'agent.
État (Status)	Statut actuel de la réponse: queued, in_progress, completed, failed ou incomplete.
Output text	Le texte de la réponse de l’agent.
Identificateur de modèle	Le modèle qui a produit la réponse.
Code d'erreur	Code d'erreur lorsque l'exécution ne s'est pas terminée correctement (status est failed). Vider en cas de réussite.
Message d’erreur	Raison de l’échec de l’exécution, lisible par un humain (status est failed). Vider en cas de réussite.
Raison incomplète	Pourquoi l’exécution s’est terminée de manière incomplète (status est incomplete), par exemple content_filter ou max_output_tokens. Vider en cas de réussite.
Jetons d’entrée utilisés	Nombre de jetons d’entrée consommés.
Jetons de sortie utilisés	Nombre de jetons de sortie produits.
Nombre total de jetons utilisés	Le nombre total de jetons consommés lors de la requête.

Affectez la sortie à une variable de processus afin qu'elle puisse influencer la progression du processus Maestro, par exemple pour se ramifier sur Statut ou utiliser la réponse du Texte de sortie.

Remarque :

Le temps de réponse de l'activité dépend de l'intervalle d'interrogation de la connexion, qui est défini par défaut sur 5 minutes. Une exécution terminée peut donc apparaître plus lente que son temps d'achèvement réel.