Invocar agente

Invoca un agente de Microsoft Azure AI Foundry creado en la API de respuestas en un proceso agéntico de Maestro.

Descripción

Esta actividad permite el uso de agentes de Microsoft Azure AI Foundry creados en la API de respuestas como participantes en un proceso automatizado orquestado por Maestro.

Superficies de agente de Foundry

Azure AI Foundry expone dos superficies de agente independientes en el mismo punto final del proyecto:

• Assistants (clásico): creado a través de la API /assistants . Utiliza la actividad Ejecutar el hilo para estos.
• Agentes (portal de Foundry): creados en el portal de Azure AI Foundry e invocados a través de la API de Respuestas. Utiliza Invocar agente para estos.

Nota:

Solo se verifica que los agentes de tipo solicitud y alojados funcionen con esta actividad. Los agentes del tipo de flujo de trabajo o externos no se han validado y no se ha confirmado que funcionen.

Cómo usar la actividad

Para utilizar esta actividad en un proceso agéntico de Maestro, sigue estos pasos:

1. Añade un elemento de tarea de servicio al lienzo y abre el panel Propiedades de la tarea.

2. En la sección Implementación , en la lista desplegable Acción , selecciona Iniciar y esperar al agente externo.

3. Selecciona el conector de Microsoft Azure AI Foundry .

4. Seleccione una conexión existente o cree una nueva. Para obtener más información, consulta Autenticación de Microsoft Azure AI Foundry.

5. En Actividad, selecciona Invocar agente.

6. En Agente, selecciona un agente de la lista de agentes en tu proyecto de Azure AI Foundry. Cada entrada muestra el tipo de agente junto a su nombre, por ejemplo ah-vo-script-agent (hosted).

7. En Mensaje, introduce la solicitud para enviar al agente.

8. Conecta el evento de inicio a la tarea de servicio y la tarea de servicio a un nodo de evento final en el lienzo.

9. Selecciona Depurar para ejecutar este proceso.

   La actividad siempre se ejecuta de forma asíncrona: Integration Service sondea la respuesta del agente y reanuda el paso de Maestro una vez que se completa la ejecución.

Salida

Parámetro	Descripción
Identificador de respuesta	Identificador único de la respuesta del agente.
Estado	Estado actual de la respuesta: queued, in_progress, completed, failed o incomplete.
Texto de salida	El texto de respuesta del agente.
Identificador de modelo	El modelo que produjo la respuesta.
Código de error	Código de error cuando la ejecución no se completaba correctamente (status es failed). Vacío en caso de éxito.
Mensaje de error	Razón legible por humanos por la que falló la ejecución (status es failed). Vacío en caso de éxito.
Motivo incompleto	Por qué la ejecución terminó incompleta (status es incomplete), por ejemplo content_filter o max_output_tokens. Vacío en caso de éxito.
Tokens de entrada utilizados	Número de tokens de entrada consumidos.
Tokens de salida utilizados	Número de tokens de salida producidos.
Total de tokens utilizados	Total de tokens consumidos durante la solicitud.

Asigna la salida a una variable de proceso para que pueda influir en el progreso del proceso de Maestro, por ejemplo, para ramificar en Estado, o para utilizar la respuesta de Texto de salida.

Nota:

El tiempo de respuesta de la actividad depende del intervalo de sondeo de la conexión, que por defecto es de 5 minutos. Por lo tanto, una ejecución completada puede parecer más lenta que su tiempo de finalización real.