Rotinas no Serviço de Agente do Foundry

Microsoft Foundry fornece rotinas no Serviço do Foundry Agent que executam um agente automaticamente quando um gatilho definido é acionado. Use uma rotina quando quiser uma forma nativa do projeto de dizer: "Quando ocorrer um horário, agendamento ou evento específico, invoque este agente."

Sem rotinas, as equipes geralmente criam essa camada de gatilho combinando tecnologias como agendadores, Aplicativos Lógicos, Azure Functions, filas, armazenamento personalizado e código de autenticação. As rotinas migram essa integração operacional para o Foundry para que o gatilho, a ação, as permissões, as conexões e o histórico de execução fiquem junto do agente no mesmo projeto do Foundry.

Use rotinas para automação de agente leve, como resumos diários, lembretes únicos ou verificações periódicas. Se seu cenário precisar de ramificação, vários agentes, etapas de aprovação humana ou estado complexo, use um fluxo de trabalho.

O que uma rotina contém

Uma rotina tem um gatilho e uma ação.

Componente Description
Trigger Define quando a rotina é iniciada. Um gatilho pode ser um temporizador único, uma agenda recorrente ou um evento como um problema de GitHub sendo aberto ou fechado ou uma mensagem postada em um canal de Microsoft Teams.
Ação Define o que acontece depois que o gatilho é acionado. A ação invoca um agente de prompt ou um agente hospedado usando, por padrão, a identidade do agente ou, quando explicitamente selecionada, a identidade do criador da rotina.
Input Fornece a entrada do usuário enviada ao agente. A entrada pode ser texto ou JSON.
Estado de ciclo de vida Determina se a rotina está habilitada ou desabilitada. Você pode atualizar, habilitar, desabilitar ou excluir uma rotina sem recriar o agente.
Histórico de execuções Registra cada execução de gatilho, incluindo entradas, saídas, status e um link para a resposta relacionada do agente e os detalhes do rastreamento.

O modelo de um gatilho e uma ação mantém as rotinas focadas em uma única pergunta: quando este agente deve ser executado? Ele não substitui a orquestração. Quando você precisar de várias ações, vários agentes ou lógica condicional, crie um fluxo de trabalho. O agente que uma rotina invoca pode implementar seu próprio fluxo de trabalho interno usando estruturas como Microsoft Agent Framework ou LangGraph.

Tipos de gatilho

As rotinas dão suporte a três tipos de gatilho: temporizador, recorrente e evento. A API representa um gatilho recorrente com o tipo schedule.

Tipo de gatilho Quando usar isso Example
Timer Execute um agente uma vez em uma data e hora específicas. Depois que o temporizador é acionado, a rotina fica inativa. Execute um agente de preparação para a migração em 2030-09-01T09:00:00Z.
Recorrente Executar um agente repetidamente de acordo com uma programação do tipo cron. Execute um agente de resumo de suporte em todos os dias úteis às 7h.
Acontecimento Execute um agente quando um evento externo for acionado. Por exemplo, o gatilho github_issue é acionado quando uma issue é aberta ou fechada em um repositório do GitHub que você acompanha. O custom gatilho com o teams provedor é acionado quando uma mensagem é postada em um canal de Microsoft Teams monitorado. Fazer a triagem de uma issue do GitHub quando ela for aberta ou responder a uma mensagem no Teams quando for publicada.

Como as rotinas são executadas

Quando uma rotina é ativada, o Foundry gerencia o gatilho e o caminho de expedição para você.

  1. O disparador é acionado por um temporizador, um agendamento recorrente ou um evento externo.
  2. A Foundry cria um registro de execução de rotina no projeto.
  3. O Foundry invoca o ponto de extremidade do agente configurado com a entrada da rotina.
  4. O agente processa a solicitação usando seu modelo configurado, instruções, ferramentas e identidade de expedição.
  5. O Foundry armazena o status da execução da rotina e associa a execução à resposta do agente e aos detalhes do rastreamento.

Esse fluxo usa o caminho de invocação do agente existente, para que as rotinas não introduzam um runtime separado para a lógica do agente. O agente continua a usar a mesma configuração, ferramentas e recursos de observabilidade que usa quando é invocado por um aplicativo ou no playground. Como as rotinas reutilizam esse caminho, elas também funcionam com projetos protegidos por uma rede virtual e herdam a configuração de rede do projeto. Para obter mais informações, consulte Configurar a rede privada para o Serviço do Foundry Agent.

Rotinas não dão suporte à criptografia cmk (chave gerenciada pelo cliente). Não use rotinas para cargas de trabalho que exijam proteção do CMK.

Conexões, identidade e governança

As rotinas estão restritas a um projeto do Foundry. Você gerencia rotinas com o mesmo modelo de governança de projeto usado para agentes, ferramentas e conexões. Para obter mais informações, consulte controle de acesso baseado em funções no Azure Foundry.

Os gatilhos de evento usam conexões de projeto para se autenticar no sistema externo. Por exemplo, o gatilho github_issue depende de uma conexão do conector do GitHub. O gatilho custom com o provedor teams depende de uma conexão do conector do Microsoft Teams. Foundry provisiona essas conexões no namespace de conectores da sua conta. Para obter mais informações, consulte Adicionar servidores MCP com tecnologia de namespaces do conector.

Cada rotina invoca seu agente usando a identidade do agente por padrão, independentemente do tipo de gatilho. Se o agente tiver ferramentas que exigem acesso delegado ao usuário, selecione explicitamente a identidade do criador ao criar a rotina. A identidade do criador refere-se apenas à entidade de serviço que cria a rotina. Não é o criador do agente, o editor do agente, o criador de conexões, um editor de rotina posterior ou outro usuário final. Você não pode fornecer uma identidade arbitrária de usuário final no momento do envio.

A identidade de despacho é definida no momento da criação. Para alternar uma rotina existente entre a identidade do agente e do criador, exclua-a e recrie-a. A autenticação do conector é separada da identidade de envio, portanto selecionar a identidade do criador não altera a identidade armazenada em uma conexão do GitHub ou do Teams. Para obter detalhes de configuração e um exemplo REST, consulte Escolher uma identidade de expedição.

Esse design com escopo de projeto fornece os seguintes benefícios:

  • Nenhum recurso de agendador separado a ser gerenciado: crie e opere rotinas do Foundry em vez de provisionar uma infraestrutura de automação separada.
  • Governança compartilhada: aplique o controle de acesso no nível do projeto ao gerenciamento de rotina e à invocação de agente.
  • Execuções observáveis: analise execuções de rotina junto com as respostas e os rastreamentos do agente que elas geram.

Não inclua segredos, credenciais ou tokens de acesso pessoal em prompts ou entradas de rotina. Use conexões de projeto e acesso baseado em Microsoft Entra ID sempre que houver suporte.

Monitorar e executar rotinas

Depois de criar uma rotina, use o histórico de execução para entender o que aconteceu cada vez que o gatilho foi disparado. O histórico de execuções ajuda você a responder perguntas operacionais como:

  • O gatilho foi acionado?
  • Qual entrada foi enviada ao agente?
  • A invocação do agente foi concluída com êxito ou falhou?
  • Que resposta o agente produziu?
  • Qual rastreamento contém as informações detalhadas do modelo, da ferramenta e da latência para essa invocação?

Você pode pausar uma rotina desabilitando-a e retomá-la habilitando-a novamente. Você também pode atualizar o gatilho, a ação ou a entrada para uma rotina existente sem recriar o agente.

Lembretes agendados pelo agente

As rotinas iniciam um agente a partir de um gatilho externo. Um agente hospedado também pode se agendar para ser executado novamente mais tarde chamando uma ferramenta de lembrete interna que você expõe por meio de uma caixa de ferramentas. O agente decide, durante uma execução, que precisa fazer um acompanhamento, define o atraso, e o serviço reinvoca o agente na mesma conversa quando esse prazo se esgota. Use este padrão para acompanhamentos conduzidos por agente, como verificar novamente o andamento de uma tarefa de longa duração. Para obter etapas, consulte Automatizar agentes com rotinas.

Rotinas e fluxos de trabalho

Rotinas e fluxos de trabalho ajudam a automatizar cenários de agente, mas resolvem problemas diferentes.

Dimensão Rotinas Fluxos de trabalho
Pergunta respondida Quando meu agente deve ser executado? Como várias etapas, decisões ou agentes devem se conectar?
Modelo mental Gatilho para o agente. Gráfico de nós, bordas, ramificação e estado.
Relação de agente Estende um agente existente com um gatilho automático. Orquestra agentes e lógica de negócios em um fluxo de trabalho separado.
Suporte a vários agentes Não. Uma rotina invoca um agente. Sim. Use fluxos de trabalho para orquestração de vários agentes.
Mais adequado para Temporizadores, agendamentos e automação leve. Ramificações, aprovações, processos em várias etapas e automação complexa com controle de estado.

Use uma rotina primeiro quando a automação for simplesmente "executar esse agente quando algo acontecer". Mova para fluxos de trabalho quando a automação precisar de lógica de coordenação além de uma invocação de agente único.

Limitações

As rotinas têm as seguintes limitações:

  • Uma rotina tem exatamente um gatilho e uma ação.
  • As rotinas oferecem suporte a agentes com prompt e agentes hospedados. Eles não dão suporte a agentes de fluxo de trabalho.
  • As rotinas podem ser temporizadores de execução única, agendamentos recorrentes ou baseadas em eventos. Os gatilhos de evento com suporte são eventos de issues do GitHub e mensagens de canal do Microsoft Teams.
  • A única ação é invocar um agente por meio da API de Respostas ou da API de Invocações. O protocolo do agente deve corresponder à ação.
  • Cada rotina usa a identidade do agente por padrão. A identidade do criador é uma opção explícita no momento da criação e sempre se refere ao principal que cria a rotina.
  • Rotinas dão suporte a projetos protegidos por uma rede virtual. Eles não dão suporte à criptografia cmk (chave gerenciada pelo cliente).
  • As rotinas não estão disponíveis no Oeste do Reino Unido, Oeste da Suíça, Oeste do Japão, Norte dos Emirados Árabes Unidos ou Leste da Noruega.
  • Os agendamentos recorrentes têm um intervalo mínimo de cinco minutos.
  • A entrega de rotina faz até cinco tentativas em caso de falhas transitórias. Cada solicitação de agente downstream tem um tempo limite de 30 segundos. Para ações de API de Respostas, o tempo limite abrange a aceitação da solicitação em segundo plano, não a conclusão do trabalho do agente.

Conteúdo relacionado

  • Last updated on