O bloco Agent

AgentsO bloco Agent
Zoen

No canvas, um bloco Agent parece qualquer outro passo: uma execução chega no handle de entrada, e um resultado sai do outro lado. Por dentro, é uma máquina de conversa. Este vídeo segue os dados entrada adentro, estação por estação.

What you will learn

A pilha de mensagens

Toda execução começa a partir de uma conversa: sua system message, qualquer histórico que você pré-carregue, e a mensagem de usuário mais recente — preenchida a partir dos blocos anteriores.

Um cérebro trocável

O campo Model escolhe qual provedor e modelo leem a pilha. O bloco ao redor nunca muda, então você pode entregar a mesma conversa a um cérebro diferente sem reconstruir o passo.

Tokens entrando, tokens saindo

Tudo na pilha é enviado ao modelo e cobrado como input; a resposta volta em stream e é cobrada como output. Ferramentas anexadas ao bloco podem ser chamadas no meio da execução.

O pacote de saída

Toda execução termina em um pacote registrado — o conteúdo, o modelo, as contagens de tokens e quaisquer chamadas de ferramenta — que blocos posteriores leem por connection tags.

Aqui está o workflow que o vídeo percorre: o agente Qualify entre sua entrada e seu resultado:

O que tem dentro do bloco

A primeira estação é a pilha de mensagens: sua system message (as instruções permanentes), qualquer histórico que você pré-carregue — exemplos trabalhados ou uma conversa anterior — e a mensagem de usuário mais recente, que normalmente chega de um bloco anterior por uma connection tag. A segunda estação é o modelo: o cérebro que lê a pilha inteira. O Zoen oferece suporte aos provedores de fronteira e, como o bloco permanece o mesmo enquanto o modelo muda, trocar cérebros nunca significa reconstruir o passo.

O que uma execução custa e retorna

Quando a execução chega ao modelo, cada mensagem na pilha vai como tokens de input; a resposta volta em stream como tokens de output. Se houver ferramentas anexadas, o modelo pode chamá-las no meio da execução. Tudo que a execução fez — o conteúdo que escreveu, o modelo que rodou, a conta de tokens, as chamadas de ferramenta — cai nas saídas do bloco, onde qualquer bloco posterior pode ler.

Onde se encaixa

O bloco Agent é o passo de raciocínio de um workflow de IA. Todo o resto no construtor de workflows do Zoen é determinístico: triggers disparam, blocos transformam dados, tabelas os armazenam. O bloco Agent é onde um modelo de linguagem lê a conversa que você configurou e decide o que escrever. A maioria dos agentes de IA que você constrói no Zoen são workflows comuns com um ou mais blocos Agent fazendo o pensamento.

Common Questions

O Zoen oferece suporte aos provedores de modelo de IA de fronteira, incluindo Anthropic Claude, OpenAI GPT e Google Gemini. O campo Model no bloco escolhe qual roda, e você pode mudá-lo a qualquer momento sem reconstruir o passo do workflow.
Por tokens. Cada mensagem na pilha vai ao modelo como tokens de input, e a resposta é cobrada como tokens de output. A saída do bloco registra as contagens exatas de tokens de cada execução.
Sim. A seção Messages aceita turnos de usuário e assistente além da system message, então uma execução pode começar a partir de exemplos trabalhados ou de uma conversa anterior.
Um pacote estruturado com o conteúdo que escreveu, o modelo que rodou, as contagens de tokens de input e output, e quaisquer chamadas de ferramenta que fez. Blocos seguintes leem esses campos por connection tags como <agent.content>.

Documentação relacionada