Conceitos de fluxo de trabalho

Os fluxos de trabalho do Agent Framework definem caminhos de execução explícitos e inspecionáveis para coordenar código, agentes, estado, eventos e entrada humana. A estrutura fornece APIs funcionais e baseadas em grafo no mesmo modelo de execução de fluxo de trabalho.

APIs de fluxo de trabalho

Todos os SDKs dão suporte a fluxos de trabalho baseados em grafo. Python fornece, além disso, uma API de fluxo de trabalho funcional experimental.

O SDK do .NET usa a API WorkflowBuilder baseada em grafo. Conecta executores tipados por meio de arestas e condições, suporta execução fan-out e fan-in, emite eventos de fluxo de trabalho e de executor e verifica o progresso nos limites do superpasso. Fluxos de trabalho compatíveis podem ser expostos por meio da interface do agente padrão com AsAIAgent().

Ambas as APIs produzem os mesmos resultados de fluxo de trabalho observáveis. Escolha a API que corresponde ao modelo de execução que você deseja expressar:

Funcional (@workflow) Grafo (WorkflowBuilder)
Fluxo de controle Python nativo (if, loops, asyncio.gather) Bordas e condições
Mais adequado para Pipelines sequenciais, loops personalizados e paralelismo ad hoc Grafos fixos, fan-out/fan-in e roteamento de mensagens com validação de tipo
Parallelism asyncio.gather Grupos de arestas paralelos e execução do superpasso
Observabilidade Eventos por passo com @step Eventos por executor
Interação humana no circuito ctx.request_info() RequestInfoExecutor
Verificação Cache de resultado por @step Verificações nos limites do superpasso
Encapsulamento do agente .as_agent() em FunctionalWorkflow .as_agent() em Workflow

O SDK do Go usa a API baseada em grafo workflow.NewBuilder. Conecta executores vinculados por meio de arestas, condições e grupos fan-out ou fan-in e, em seguida, executa o grafo em um ambiente de execução como inproc.Default. Os fluxos de trabalho orientados ao agente podem ser expostos por meio da interface do agente padrão com agentworkflow.New(...).

Grafo e modelo de tempo de execução

  • Os executores recebem entradas, executam o trabalho e emitem saídas.
  • Arestas roteiam valores entre executores.
  • Os eventos expõem o ciclo de vida e a atividade de execução do fluxo de trabalho.
  • Gerenciamento de estado controla o estado do fluxo de trabalho durável e com escopo de execução.

Execução avançada

Para orientações orientadas a recursos, como pontos de verificação, interação humana, visualização e orquestrações, consulte Recursos do fluxo de trabalho.

Próximas Etapas