A Jornada do meu Agente: Por trás do Brilho Verde

Fala, pessoal! Vou mostrar para vocês como eu arquitetei a comunicação desse sistema de IA. Para facilitar, pensem no meu fluxo como uma jornada em quatro etapas principais:

1. O Gatilho: Eu criei a porta de entrada

No primeiro quadro, vocês veem o n8n atuando como o meu Robô Mensageiro. Eu configurei um Webhook que fica 'ouvindo' a porta 5678. Assim que eu disparo um comando pelo VS Code, esse robô toca o sino. Ele é o gatilho orientado a eventos que inicia toda a mágica, recebendo o documento legal que precisa de análise.

Conceito que apliquei: Endpoints HTTP e Gatilhos Orientados a Eventos.

2. Orquestração: Eu preparo os dados

Depois que a 'carta' chega, eu não a envio de qualquer jeito. No segundo quadro, o robô atua como Preparador. Eu fiz um Data Mapping para garantir que o texto do contrato seja extraído do JSON original e colocado em um novo envelope, um novo JSON, que o meu backend em Python consiga processar. É aqui que eu organizo a estrutura dos dados.

Conceito que apliquei: Manipulação de Data Mapping e Transformação de JSON.

3. O Salto da Bridge: Eu conecto o Docker ao Windows

Esse é o 'pulo do gato' técnico. O n8n está rodando isolado dentro de um container Docker, a caixa cinza no terceiro quadro. Para ele conseguir 'falar' com o meu servidor FastAPI que está rodando direto no meu Windows, eu utilizei o endereço host.docker.internal. É como se eu tivesse construído uma passagem secreta na rede para o dado sair do container e chegar na porta 8000 do meu host.

Conceito que apliquei: Docker Networking e DNS Resolution.

4. Resposta e Brilho: A Inteligência em ação

Por fim, no quarto quadro, o meu Agente Python, a cobra de capacete, representando o código recebendo o contrato e usa a OpenAI para processar a análise. Assim que a IA termina, meu backend devolve um status 200 OK. No momento em que o n8n recebe esse sinal de sucesso, o nó brilha em verde na tela, confirmando que o contrato foi analisado e o resultado está pronto!

Confira o projeto no meu GitHub: https://github.com/viniciushoffmanndev/ai-agents-orchestrator-fastapi-n8n