Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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. O framework fornece APIs funcionais e baseadas em grafos sobre o mesmo modelo de execução de workflow.
Workflow APIs
Todos os SDKs suportam fluxos de trabalho baseados em grafos. O Python também fornece uma API experimental de fluxo de trabalho funcional.
O SDK .NET utiliza a API baseada WorkflowBuilder em grafos. Liga executores tipados através de arestas e condições, suporta execução fan-out e fan-in, emite fluxos de trabalho e eventos do executor, e os checkpoints progridem nos limites do superstep. Fluxos de trabalho compatíveis podem ser expostos através da interface padrão do agente com AsAIAgent().
- O Workflow Builder e execução explica como construir e executar grafos de workflow .NET.
- Executores, arestas, eventos e gestão de estados descrevem as primitivas de execução do grafo.
- A API de Workflow Funcional utiliza funções em Python e um fluxo de controlo nativo.
- O Workflow Builder e a execução constrói e executa grafos de workflow validados por tipo.
Ambas as APIs produzem os mesmos resultados de workflow observáveis. Escolha a API que corresponda ao modelo de execução que pretende expressar:
Funcional (@workflow) |
Gráfico (WorkflowBuilder) |
|
|---|---|---|
| Fluxo de controlo | Python nativo (if, loops, asyncio.gather) |
Arestas e condições |
| Ideal para | Pipelines sequenciais, loops personalizados e paralelismo ad-hoc | Grafos fixos, encaminhamento de mensagens por fan-out/fan-in e validação por tipo |
| Paralelismo | asyncio.gather |
Grupos paralelos de arestas e execução em superstep |
| Observabilidade | Eventos por passo com @step |
Eventos por executor |
| Humano no ciclo | ctx.request_info() |
RequestInfoExecutor |
| Pontos de controlo | Cache por@step resultado |
Pontos de verificação de limite de superetapa |
| Encapsulamento do agente |
.as_agent() em FunctionalWorkflow |
.as_agent() em Workflow |
O Go SDK utiliza a API baseada workflow.NewBuilder em grafos. Liga executores limitados através de arestas, condições e grupos fan-out ou fan-in, depois executa o grafo através de um ambiente de execução como inproc.Default. Fluxos de trabalho orientados a agentes podem ser expostos através da interface padrão do agente com agentworkflow.New(...).
- O Workflow Builder and Execution explica como construir e executar grafos de workflow Go.
- Executores, arestas, eventos e gestão de estados descrevem as primitivas de execução do grafo.
Gráfico e modelo de tempo de execução
- Os executores recebem entradas, realizam trabalho e emitem saídas.
- As arestas encaminham valores entre executores.
- Os eventos expõem o ciclo de vida do fluxo de trabalho e a atividade de execução.
- A gestão de estados controla o estado de fluxo de trabalho duradouro e com âmbito de execução.
Execução avançada
- O Agent Executor integra agentes em grafos de workflow.
- Os Modos de Execução de Workflow explicam a execução em streaming e não em streaming.
- Executores Resetáveis descrevem executores que reiniciam entre execuções.
- Sub-Workflows compõe fluxos de trabalho como executores em grafos maiores.
Para orientações orientadas a funcionalidades, como checkpoints, human-in-the-loop, visualização e orquestrações, consulte Capacidades de Fluxo de Trabalho.