← Guias · English · 日本語 · 中文

Atualizado 2026-11-20

Nesta página
  1. O que é um Bot
  2. Passo 1 — Criar
  3. Passo 2 — Atribuir o resultado
  4. Uma primeira atribuição limitada
  5. Passo 3 — Trabalhar com ele
  6. Passo 4 — Direcionar pela memória, não por microgestão
  7. Antes de compartilhar — acesso e uso
  8. Passo 5 — Colocar onde você trabalha
  9. Passo 6 — Agendamentos e modos
  10. Ciclo de vida
  11. Checklist de verificação
  12. Armadilhas
  13. Teste de conhecimento
  14. Fontes

Guia 1 — Seu primeiro Bot

Objetivo: criar um Devin Bot que assume um resultado e aprender as seis mecânicas nas quais todos os guias seguintes se apoiam. Nível: comece aqui · Tempo: ~15 minutos Fonte: documentação oficial de Bots, post de lançamento

O que é um Bot

Uma sessão atende a um pedido. Um Bot é dono de um resultado: você declara a meta uma vez no chat dele, ele planeja o trabalho, inicia uma sessão Devin filha para cada parte, monitora todas e só traz até você o que exige seu julgamento. Ele persiste — memória, sessões e automações sobrevivem por semanas.

As seis mecânicas, na ordem em que você vai encontrá-las:

Mecânica O que é Onde você a usa
Chat Uma thread para tudo que o Bot possui — metas, relatórios, perguntas A página do Bot / Slack / iMessage
Sessions Cada parte do trabalho roda como sua própria sessão Devin em sua própria máquina Criadas e monitoradas pelo Bot
Needs you Decisões, revisões de PR, pedidos de permissão, relatórios — uma única lista No topo do chat do Bot
Memory O que o Bot aprende, salvo como arquivos, lido no início de cada sessão Settings → Memory
Instructions Regras permanentes escritas por pessoas, lidas no início de cada sessão Settings → General
Access As conexões/segredos do próprio Bot, além de grants entre Bots Settings → Access

Passo 1 — Criar

Sidebar → Bots → Create new Bot → escolha um template ou Start from scratch → dê um nome.

Um Bot novo é privado para você até ser compartilhado. Seu uso conta no seu plano como qualquer sessão.

Dica: a Template library (barra lateral → Bots) lista os templates da Cognition — QA Engineer, Migration Engineer, Data Analyst, … — além dos compartilhados na sua org; o mesmo conjunto dá para explorar sem login no Bot marketplace público. Start from scratch continua sendo a escolha certa para os guias deste repositório — você vai escrever o prompt de resultado você mesmo.

Um Bot criado de template recebe o prompt e mais nada — é privado, sem connections, secrets ou memory. Diga no chat do que ele é dono (repositório, projeto, canal), configure as connections como em qualquer Bot novo e, se o template roda num gatilho, o Bot se oferece para configurá-lo no primeiro contato. Ele guarda a própria cópia do prompt — edições posteriores no template não chegam até ele. (Add to a current Bot manda o prompt do template para um Bot que você já tem, em vez de criar um novo.)

Passo 2 — Atribuir o resultado

A primeira mensagem é o input mais importante que um Bot já recebeu. Dê a ele uma meta, não uma tarefa:

You own the Android app now. Keep it at feature parity with iOS.

Esse é o prompt literal com que o Android Bot da Cognition começou. Compare:

Fraco (uma tarefa) Forte (um resultado)
"Fix the checkout button" "You own checkout. Keep it fast, correct, and covered by tests."
"Update the docs" "You own the docs. Keep them in step with main."
"Watch CI" "You own build health on main. When a check regresses, find the cause and fix it."

Uma tarefa acaba quando termina; um resultado faz o Bot re-planejar para sempre.

Uma primeira atribuição limitada

"Propriedade" é a forma certa, mas delimite a superfície na primeira rodada: um fluxo, um ambiente, um revisor — você. O padrão do guia de campo ANO é o ponto de partida confiável:

Own the newsletter signup check for [project] on staging.
Use [repository], [staging URL] and the test mailbox I provide.
Check the journey from submitting the form to receiving the
correct welcome email and opening its resource link.

Start with one run. Show me the result before proposing a schedule.
If you find a defect, reproduce it, make the smallest suitable fix,
and open a pull request with the evidence.

Do not merge, deploy, email real subscribers, change billing,
or connect another service without asking me.

Return: what passed/failed, screenshots or a short recording,
the PR if a fix was needed, anything you could not verify,
and any decision you need from me.

As linhas estruturais: a definição da jornada (formulário → email → link, não só "o form funciona"), uma execução antes do agendamento, a cerca explícita de não-merge/não-deploy, e a evidência nomeada que você espera. Amplie a atribuição só depois que o Bot devolver evidência confiável duas vezes.

Passo 3 — Trabalhar com ele

Depois que o resultado está definido, a maioria das suas mensagens são check-ins:

anything waiting on me?

Abra Needs you (topo do chat) quando o Bot sinalizar algo:

Item Sua ação
Decision Escolha uma opção — o Bot marca sua recomendação
Review PR / Merge PR Revisar ou mergear
Permission request Aprovar ou rejeitar novo acesso, uma automação, um host de rede ou aumento de limite de uso
Report / FYI Leia

Você pode responder com suas próprias palavras, adiar ou descartar qualquer item.

Passo 4 — Direcionar pela memória, não por microgestão

O padrão que escala: corrija o Bot uma vez, deixe-o gravar a correção na memória, e toda sessão futura a herda. A Cognition mergeia mais de 2.000 PRs/semana nesse loop.

Antes de compartilhar — acesso e uso

Duas coisas que os posts de lançamento pulam e a documentação explicita:

Passo 5 — Colocar onde você trabalha

Passo 6 — Agendamentos e modos

Ciclo de vida

Ação Efeito
Recycle Termina a sessão atual; uma nova começa na próxima abertura. No menu do chat.
Archive Para as respostas, remove das listas de Bots, remove seu app Slack e grants entre Bots (desarquivar não os restaura — você os configura de novo).
Delete Permanente: configurações, sessões, memória, automações. Não pode ser desfeito.

Apenas o criador e papéis com Manage Bots veem Archive/Delete. Em planos Enterprise, Use Bots / Manage Bots / Manage Bots across the enterprise são permissões separadas em papéis personalizados.

Checklist de verificação

Armadilhas

Teste de conhecimento

  1. O que sobrevive entre as sessões de um Bot que uma sessão avulsa não tem? (Memória — mais o resultado permanente, agendamentos e superfícies.)
  2. Por que um Bot usa "needs-you" em vez de perguntar no meio da sessão? (O julgamento vai para uma thread assíncrona; o humano não é uma chamada bloqueante no loop.)
  3. Qual mecânica transforma "uma sessão esperta" em "um funcionário"? (A propriedade de um resultado — a meta persiste depois que qualquer sessão termina.)

Fontes