Ir para o conteúdo

Lab 034: Padrões de Orquestração do Microsoft Agent Framework

Level: L300 Jornada: ai-agents Tempo: ~120 min Custo: free

Phase 3 · local first

O caminho obrigatório é determinístico e local. O caminho Real é opcional e inclui estimativa e limpeza.

O que você aprenderá

  • Comparar padrões sequencial, concorrente, handoff, group chat e magentic
  • Escolher padrão por necessidades mensuráveis
  • Adicionar checkpoints, orçamentos e condições de parada
  • Avaliar resultado e overhead

Pré-requisitos

  • Python 3.10+ e um terminal
  • Nenhuma credencial para o caminho obrigatório
  • Leia a especificação oficial vinculada antes de usar um adaptador hospedado

Modelo visual

flowchart TB
  O[Orchestrator] --> S[Sequential]
  O --> C[Concurrent]
  O --> H[Handoff]
  O --> G[Group chat]
  O --> M[Magentic]
  S & C & H & G & M --> E[Evaluation]

Cenário

A OutdoorGear precisa de uma implementação revisável para workshop, com fixtures determinísticas, fronteiras de confiança explícitas, critérios mensuráveis e adaptador hospedado opcional e reversível.

Exercício guiado

Step 1: run_sequential

  1. Execute a fixture determinística desta etapa.
  2. Registre entrada, saída, decisão de política e comportamento de falha.
  3. Altere um comportamento limitado e execute o teste local novamente.

Evidence: Salve comando, resultado e uma frase explicando por que a evidência é confiável.

Step 2: run_concurrent

  1. Execute a fixture determinística desta etapa.
  2. Registre entrada, saída, decisão de política e comportamento de falha.
  3. Altere um comportamento limitado e execute o teste local novamente.

Evidence: Salve comando, resultado e uma frase explicando por que a evidência é confiável.

Step 3: test_handoff_group

  1. Execute a fixture determinística desta etapa.
  2. Registre entrada, saída, decisão de política e comportamento de falha.
  3. Altere um comportamento limitado e execute o teste local novamente.

Evidence: Salve comando, resultado e uma frase explicando por que a evidência é confiável.

Step 4: compare_magentic

  1. Execute a fixture determinística desta etapa.
  2. Registre entrada, saída, decisão de política e comportamento de falha.
  3. Altere um comportamento limitado e execute o teste local novamente.

Evidence: Salve comando, resultado e uma frase explicando por que a evidência é confiável.

Execute localmente

cd docs/docs/pt/labs/lab-034
python -m unittest discover -v

Simulação / Caminho Real

Use as fixtures determinísticas e o validador local incluídos. Custo estimado: **US$0**.

Kit de apoio

O build do site gera downloads estáveis em PDF e ZIP. A CI também mantém um espelho temporário por 30 dias.

Quiz pontuado

Por que manter um contrato local?
Resposta

Ele cria uma linha de base determinística antes de adicionar variabilidade e custo hospedados.

Quando o caminho Real termina?
Resposta

Somente após registrar evidência de validação e limpeza.

Como tratar a saída de ferramentas?
Resposta

Como dado não confiável até a validação de política e esquema.

Critérios de saída

  • Testes locais passam sem credenciais.
  • O diagrama tem explicação textual e não depende de cor.
  • O quiz pontuado foi revisado.
  • O caminho Real tem teto de custo e plano de limpeza.
  • Fontes e estabilidade foram verificadas.

Fontes públicas oficiais