Invocar agente

Invoque um agente do Microsoft Azure AI Foundry criado na API Responses em um processo com agente do Maestro.

Description

Essa atividade permite o uso de agentes do Microsoft Azure AI Foundry criados na API Responses como participantes de um processo automatizado orquestrado pelo Maestro.

Superfícies do agente Foundry

O Azure AI Foundry expõe duas superfícies de agente separadas no mesmo ponto de extremidade do projeto:

• Assistants (clássico) — criados por meio da API /assistants . Use a atividade Execute a thread para esses.
• Agentes (portal Foundry) — criados no portal do Azure AI Foundry e invocados por meio da API Responses. Use Invoke Agent para eles.

Observação:

Apenas agentes do tipo solicitação e hospedado são verificados para funcionar com esta atividade. Agentes do tipo fluxo de trabalho ou externos não foram validados e não estão confirmados para funcionar.

Como usar a atividade

Para usar essa atividade em um processo com agente do Maestro, siga estas etapas:

1. Adicione um elemento de tarefa de serviço à tela e abra o painel de Propriedades da tarefa.

2. Na seção Implementação , na lista suspensa Ação , selecione Iniciar e aguardar agente externo.

3. Selecione o conector Microsoft Azure AI Foundry.

4. Selecione uma conexão existente ou crie uma nova. Para obter mais informações, consulte Autenticação do Microsoft Azure AI Foundry.

5. Na Atividade, selecione Invoke Agent.

6. Em Agente, selecione um agente da lista de agentes em seu projeto do Azure AI Foundry. Cada entrada mostra o tipo do agente ao lado do seu nome, por exemplo,.ah-vo-script-agent (hosted)

7. Em Mensagem, insira o prompt a ser enviado ao agente.

8. Conecte o evento de início à tarefa de serviço, e a tarefa de serviço a um nó de evento final na tela.

9. Selecione Debug para executar esse processo.

   A atividade sempre é executada de forma assíncrona: o Integration Service pesquisa a resposta do agente e retoma a etapa do Maestro após a conclusão da execução.

Saída

Parâmetro	Description
Identificador de resposta	Identificador exclusivo da resposta do agente.
Status	Status atual da resposta: queued, in_progress, completed, failed ou incomplete.
Output text	O texto da resposta do agente.
Identificador de modelo	O modelo que produziu a resposta.
Código de erro	Código de erro quando a execução não foi concluída com sucesso (status é failed). Vazio se for bem-sucedido.
Mensagem de erro	Motivo legível por humanos pela falha da execução (status é failed). Vazio se for bem-sucedido.
Motivo incompleto	Por que a execução terminou incompleta (status é incomplete), por exemplo, content_filter ou max_output_tokens. Vazio se for bem-sucedido.
Tokens de entrada usados	Número de tokens de entrada consumidos.
Tokens de saída usados	Número de tokens de saída produzidos.
Total de tokens usados	Total de tokens consumidos durante a solicitação.

Atribua a saída a uma variável de processo para que ela possa influenciar o progresso do processo do Maestro, por exemplo, para ramificar no Status ou usar a resposta do Texto de saída.

Observação:

O tempo de resposta da atividade depende do intervalo de pesquisa da conexão, que é padrão de 5 minutos. Portanto, uma execução concluída pode parecer mais lenta do que seu tempo de conclusão real.