# Agent Design Canvas · Builder — Para times que vão construir o agente.

> Use quando o projeto já foi aprovado e o time precisa alinhar arquitetura, dados, integrações e critérios de sucesso antes de escrever código.

- Dimensões: 12
- Autor: Rafael Souza (https://rafaelsouza.me)
- Canônico: https://rafaelsouza.me/workshops/agent-canvas/builder
- PDF imprimível: https://rafaelsouza.me/agent-canvas-builder.pdf

## Por que um canvas

Discoveries de IA aplicada tendem a começar pela ferramenta — escolha do modelo, framework, vector store. O que mais erra na transição entre PoC e produto não é o stack, é a definição do que o agente faz, o que ele não faz, e quem é dono quando ele erra.

Este canvas serve como um passo zero. Ele força conversas que normalmente só aparecem em produção: gatilho real, formato de saída, supervisão humana, critério de sucesso. Quanto mais cedo essas respostas existem por escrito, menos retrabalho.

## Como usar

- **Imprima ou preencha em tela.** Os dados ficam só no seu navegador. Nada sai daqui.
- **Faça em time, em até 60 minutos.** Quem vai operar o agente precisa estar na sala — desenvolvedor sênior, dono do processo, alguém de produto.
- **Exporte como markdown.** Cole no Notion, README ou PR para que vire registro vivo do projeto.

## As 12 dimensões

Os exemplos abaixo vêm de um caso único e contínuo: um agente que faz triagem e qualificação dos leads recebidos pelo site.

### 01 — Nome do agente

**Pergunta:** Como esse agente é chamado?

**Como responder:** Nome curto e memorável. Evite siglas internas.

**Exemplo:** Triador de leads

### 02 — Responsável

**Pergunta:** Quem responde por este agente em produção?

**Como responder:** Pessoa, não time. Quem é acordado quando algo quebra.

**Exemplo:** Aline Pires — Head de Comercial

### 03 — Propósito

**Pergunta:** Que problema esse agente resolve, em uma frase?

**Como responder:** Se precisar de duas frases, o escopo ainda está vago.

**Exemplo:** Triar e qualificar leads recebidos pelo site, devolvendo só os com chance real de virar cliente pra equipe de vendas conversar.

### 04 — Valor & impacto

**Pergunta:** O que muda no negócio quando esse agente funciona bem?

**Como responder:** Métrica de receita, custo, tempo ou risco — escolha uma primária.

**Exemplo:** Reduzir pela metade o tempo de resposta a um novo lead e liberar o time de vendas pra focar só nos contatos com potencial. Métrica primária: tempo entre cadastro e primeira conversa qualificada.

### 05 — Gatilhos

**Pergunta:** Que eventos disparam a execução do agente?

**Como responder:** Evento de sistema, agendamento, chamada explícita, mensagem.

**Exemplo:** Toda vez que alguém preenche o formulário 'quero uma demo' no site. Evita disparo duplo se a mesma pessoa enviar duas vezes no mesmo dia.

### 06 — Entrada

**Pergunta:** Que dados o agente precisa receber para começar?

**Como responder:** Texto, JSON estruturado, IDs, contexto de sessão, anexos.

**Exemplo:** Os dados que o lead preencheu: nome, empresa, cargo, e-mail e o problema que quer resolver.

### 07 — Plano de ação (humano & IA)

**Pergunta:** Quais passos o agente executa sozinho e onde o humano entra?

**Como responder:** Marque cada passo como AGENTE, HUMANO ou REVISÃO. Pense supervisão antes de autonomia.

**Exemplo:** 1. AGENTE busca informações públicas sobre a empresa. 2. AGENTE dá uma nota de 0 a 10 para o quanto o lead combina com o cliente ideal. 3. REVISÃO de uma pessoa do time quando a nota é muito alta ou a empresa é estratégica. 4. AGENTE agenda a demo ou coloca o lead numa jornada de e-mails educativos.

### 08 — Saída

**Pergunta:** O que o agente entrega — e em que formato?

**Como responder:** Texto, ação em sistema externo, decisão, recomendação, relatório.

**Exemplo:** Lead aprovado: e-mail automático com um link para escolher horário de demo. Lead que ainda não está pronto: entra numa sequência de conteúdo por e-mail.

### 09 — Interfaces

**Pergunta:** Por onde o agente conversa com o mundo?

**Como responder:** Chat, API, e-mail, webhook, sistemas internos. Liste todas as superfícies.

**Exemplo:** Formulário do site, CRM da empresa, agenda compartilhada e e-mail transacional.

### 10 — Conhecimento & estado

**Pergunta:** Que conhecimento o agente precisa acessar — e o que ele lembra?

**Como responder:** Bases de RAG, memória de longo prazo, histórico de sessão, secrets.

**Exemplo:** Documento que descreve o cliente ideal, lista das empresas que fecharam contrato nos últimos 12 meses e histórico de conversas anteriores com a mesma empresa.

### 11 — Capacidades

**Pergunta:** Que ferramentas o agente pode chamar?

**Como responder:** Tools, funções, MCPs, modelos especializados. Cada uma com escopo limitado.

**Exemplo:** Pontuar leads com base em critérios pré-combinados. Enviar e-mails automáticos. Criar eventos na agenda do time. Registrar e atualizar contatos no CRM com tags e notas.

### 12 — Sucesso

**Pergunta:** Como saberemos que esse agente está funcionando?

**Como responder:** Critérios mensuráveis. Acurácia, custo por execução, satisfação, taxa de fallback.

**Exemplo:** Pelo menos 9 em cada 10 leads triados em menos de 30 minutos. Taxa de demos agendadas igual ou melhor que hoje. Nenhum falso-positivo marcado como urgente sem o time perceber por mais de uma semana.