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 baseada em WorkflowBuilder grafo. Ele conecta executores tipado por meio de bordas e condições, dá suporte à execução de fan-out e fan-in, emite eventos de fluxo de trabalho e executor e o progresso dos pontos de verificação nos limites de superestar. 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 Gráficos fixos, fan-out/fan-in e roteamento de mensagem validado por tipo
Parallelism asyncio.gather Grupos de borda paralela e execução de superespastas
Observabilidade Eventos por etapa com @step Eventos por executor
Human-in-the-loop ctx.request_info() RequestInfoExecutor
Verificação @step Cache por resultado Pontos de verificação de limite de superstep
Encapsulamento do agente .as_agent() em FunctionalWorkflow .as_agent() em Workflow

O SDK do Go usa a API baseada em workflow.NewBuilder grafo. Ele conecta executores associados por meio de bordas, condições e grupos de fan-out ou fan-in e executa o grafo por meio de 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 runtime

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

Execução avançada

Para obter diretrizes orientadas a recursos, como pontos de verificação, human-in-the-loop, visualização e orquestrações, consulte Recursos de Fluxo de Trabalho.

Próximas Etapas