Astra profundo · Capítulo 27 de 31 · 30 min
Conectar ferramentas ao fluxo de trabalho do Aurora
Você sai com um mapa de ferramentas e um percurso que consulta dados, produz uma peça e verifica o resultado.
Este capítulo faz parte do curso gratuito Astra profundo.
O Estúdio Aurora, caso fictício, guarda a agenda numa base, as imagens numa pasta e o site num projeto. Para preparar uma divulgação completa, o Astra precisa trabalhar com esses recursos. Você vai organizar um percurso que consulta a programação, seleciona imagens e produz uma peça, escolhendo para cada etapa a ferramenta mais adequada.
Pense numa ferramenta como uma ação com entrada e resultado definidos. Consultar uma sessão recebe um identificador e devolve data e disponibilidade; exportar uma imagem recebe arquivo e formato e devolve uma saída. Quanto mais clara for essa relação, mais fácil será combinar as ações num trabalho maior. O modelo planeja a sequência e a aplicação executa as operações disponíveis.
Ferramentas escolhidas pela ação
| Etapa | Ferramenta adequada | Resultado esperado |
|---|---|---|
| Consultar a oficina | Consulta estruturada ou conector | Data, horário e identificação da sessão |
| Selecionar a imagem | Leitura de arquivos e inspeção visual | Arquivo apropriado para a peça |
| Produzir a divulgação | Editor ou geração por código | Peça editável |
| Conferir a entrega | Visualizador ou navegador | Resultado observado no formato de uso |
No exemplo resolvido, a equipe solicita a divulgação da oficina de fotografia noturna. O agente consulta a sessão correspondente, recebe data e horário, localiza as imagens aprovadas e prepara a peça com a identidade do Aurora. Em seguida, abre o resultado para conferir legibilidade e coerência. Cada etapa consome o resultado da anterior e produz algo que pode ser examinado.
Aprofunde as decisões desta aula
Como definir ferramentas pelo trabalho que executam?
O Model Context Protocol, ou MCP, padroniza a conexão com servidores que oferecem capacidades a um cliente. A [documentação de MCP e conectores da OpenAI](https://developers.openai.com/api/docs/guides/tools-connectors-mcp) descreve essa integração. No Aurora, um conector pode tornar a agenda acessível ao fluxo, enquanto outra ferramenta permite ler arquivos. O protocolo organiza acesso; a utilidade vem das ações concretas que cada conexão oferece. Escolha primeiro a ação, depois a superfície. Para obter uma data estruturada, uma consulta direta à base pode ser mais precisa que navegar por várias telas. Para avaliar o enquadramento de uma imagem, uma ferramenta visual é apropriada. Para conferir se o visitante consegue selecionar a sessão no site, o navegador observa o comportamento real da interface.
Como compor consultas, arquivos e etapas dependentes?
Descreva o contrato de cada ferramenta com exemplos. A consulta de agenda deve distinguir sessão encontrada de consulta sem resultado. A seleção de imagem deve devolver um caminho utilizável e uma descrição. A exportação deve indicar o arquivo gerado. Essas respostas ajudam o agente a continuar o trabalho usando evidência concreta, sem precisar adivinhar se uma operação terminou. Reaproveite capacidades que já existem no ambiente. Se um editor oferece uma API adequada, o Astra pode usá-la para mudanças repetitivas; a inspeção visual continua útil para julgar a composição. O fluxo do [caso de arquitetura com Blender](https://developers.openai.com/blog/architectural-visualization-with-astra) combina programação e observação. Esse arranjo também funciona na produção de peças e páginas do Aurora. Teste o percurso com uma sessão conhecida e um conjunto pequeno de imagens. Compare os dados consultados com a peça exportada: a data permanece igual, o nome da oficina cabe e a imagem corresponde à atividade. O objetivo da prática é fechar uma cadeia curta, do pedido ao resultado, antes de ampliar o catálogo de ferramentas.
A entrega reúne o mapa de ações, seus campos e uma peça produzida pelo percurso. Você consegue explicar o papel de cada conexão e substituir uma ferramenta sem perder a intenção do trabalho. Para a equipe do Aurora, o benefício é reutilizar um procedimento claro de divulgação, mantendo agenda, imagens e apresentação ligados ao mesmo pedido.
Faça agora: feche um percurso
Em 30 minutos, use ferramentas já disponíveis e uma única oficina do caso fictício.
Passo 1: Mapeie as ações
Escreva consultar sessão, selecionar imagem, produzir peça e conferir resultado.
Deu certo quando: Cada ação tem entrada e saída.
Passo 2: Associe as ferramentas
Escolha consulta direta, editor ou navegador conforme o trabalho de cada etapa.
Deu certo quando: A escolha tem uma razão concreta.
Passo 3: Execute o exemplo
Use uma sessão conhecida e mantenha os resultados intermediários localizáveis.
Deu certo quando: A peça usa os dados consultados.
Passo 4: Documente o percurso
Registre campos, arquivos e evidência da conferência final.
Deu certo quando: A equipe consegue repetir o trabalho.
No fim você tem: Mapa de ferramentas e divulgação produzida a partir de uma sessão conhecida.
Uma ferramenta tem uma ação e um resultado definidos. MCP conecta capacidades que precisam ter utilidade concreta. O percurso completo termina numa entrega inspecionada.
Seu caderno neste capítulo
Abrir o caderno completoSelecione um trecho do capítulo para destacar ou anotar. Nos vídeos e áudios, use Anotar este momento. No teclado, selecione com Shift e as setas e use Alt+Shift+D para destacar ou Alt+Shift+N para anotar.
Salvo neste navegador. Entre na sua conta para levar o caderno a outros aparelhos.
Entre na sua conta para compartilhar o que aprendeu e convidar alguém para estudar com você.
Conexões deste capítulo
Veja o que estudar antes e para onde seguir depois, explore os conceitos e compare abordagens em outros cursos. Sugestões marcadas como “sugerido pelo grafo” vêm dos assuntos em comum, não do índice do curso.
Estude antes
- Usar o mapa do curso e o glossário mínimosugerido pelo grafoApresenta o conceito “MCP”, usado em “Conectar ferramentas ao fluxo de trabalho do Aurora”.
- CursoEscrever bem com IAsugerido pelo grafoAs primeiras aulas do Astra pedem um briefing com referências e dirigem cada iteração por texto. O curso de escrita ensina a decidir o que pedir, dar contexto e conferir a saída, que é a base dessas aulas. Ordem decidida quando o Astra ganhou uma página por aula (Etapa 4, wave 3), para que as 31 aulas mostrem o que estudar antes.
- CursoNode.js: JavaScript no Servidorsugerido pelo grafo4 capítulos de “Astra profundo” usam conceitos apresentados em “Node.js: JavaScript no Servidor”.
Conceitos deste capítulo
O mesmo assunto em outros cursos
- Agentes de IA Autônomos: Do Conceito à ProduçãoCrewAI multi-agenteExaminar conexões de CrewAI multi-agente
- Escrever bem com IATrocar de ferramenta sem perder o métodoExaminar conexões de Trocar de ferramenta sem perder o método
- Frontends com VibecodingConfigurar ambiente, skills e o contêiner de contextoExaminar conexões de Configurar ambiente, skills e o contêiner de contexto
Voltar ao capítulo anterior: Projetar uma integração pequena com a Responses API
Leve uma ideia para a prática
Escolha uma atividade no painel e volte a este curso quando quiser.
Atividades e evolução ficam reunidas no painel da sua conta.
Capítulos vizinhos em Astra profundo
- 25Preparar uma versão do Aurora para publicação com Sites
- 26Projetar uma integração pequena com a Responses API
- 27Conectar ferramentas ao fluxo de trabalho do Aurora
- 28Coordenar tarefas paralelas e incorporar uma mudança de direção
- 29Calcular custo e escolher modelos por resultado