Buscar na documentação

Notas do agente

Dê a cada Perfil um caderno para notas de trabalho e depois puxe o que se provar útil para suas Fontes.

Um caderno por Perfil

A maioria dos agentes começa cada conversa ou execução do zero. Notas dão a cada Perfil um caderno: um workspace para pensamentos de trabalho que ainda não são Fontes. Após um trabalho, um agente deixa uma nota: o problema, o que tentou, o que funcionou, o que falhou, o que fazer na próxima vez e as Fontes que usou. Antes de um trabalho semelhante, ele procura nessas notas primeiro.

Toda chave em um Perfil lê e escreve o mesmo caderno, então Claude, Cursor e um trabalho agendado todos conectados como Suporte trabalham do mesmo lugar. Outros Perfis nunca o veem, a menos que você ative Ler todas as notas para um que precisa do quadro completo, como um bot de revisão que lê cada caderno uma vez por semana. Essa permissão só lê. Nunca edita ou exclui as notas de outro Perfil. Conecte ferramentas através do mesmo Perfil quando elas devem trabalhar juntas, e use Perfis separados quando seu trabalho deve permanecer separado.

Notas são opcionais por Perfil. Ative Deixar e curar ao criar o Perfil — ou depois no editor de perfil — para agentes que devem manter notas, e adicione Exportar rascunhos apenas onde um fluxo de rascunho é desejado. Adicione Ler todas as notas apenas a um revisor que lê entre cadernos. Perfis sem Notas não aparecem na visualização de Notas.

O que os agentes escrevem e leem

Hábitos de notas de agentes
HábitoSignificado
Escrever uma nota após o trabalhoApenas o problema é obrigatório, mas sempre adicione uma tag de projeto. Varreduras filtradas por tag nunca veem notas sem tag.
Pesquisar antes de começarUma pesquisa retorna as duas melhores correspondências das notas do Perfil, marcadas como não confiáveis.
Verificar antes de confiarUma nota é uma pista de outro agente, não uma Fonte. Pode estar errada, incompleta ou desatualizada, então o agente deve verificar as Fontes que cita antes de usar uma afirmação.
takibi notes search -q "refund exception"
takibi notes append \
  --project support \
  --problem "Refund replies missed the policy exception" \
  --worked "The current policy lists the exception" \
  --next-time "Check the policy date before replying" \
  --source <document-id> --run-id <run-id>

A API bloqueia segredos óbvios em vez de armazená-los. Mantenha credenciais e dados privados fora das notas mesmo assim. Escreva os quatro campos do corpo em Markdown — listas curtas, código, links e tabelas são renderizados quando o fundador lê a nota. O título permanece texto simples. Para cada campo e comando, leia API de Notas do Agente.

Veja o que seus agentes estão aprendendo

Abra Notas no aplicativo e escolha um Perfil por seu avatar e nome. A primeira visualização é uma fila curta de notas que merecem sua atenção, não todas as notas. Notas que várias chaves continuam procurando e notas sobre problemas que suas Fontes podem não cobrir sobem para o topo. Uma tag em cada nota diz por que ela apareceu.

Essas tags são sinais, não prova de que uma nota está certa ou de que uma Fonte está faltando. Selecione o título de uma nota para ler o registro completo antes de decidir qualquer coisa. O registro renderiza Markdown nos campos do corpo; o título permanece texto simples.

Todas as notas mostra tudo o que o Perfil tem, incluindo notas sinalizadas e notas expiradas. Pesquise lá para estreitar a lista. Uma sinalização significa que outra nota contradiz esta — ambas ficam visíveis para você e para agentes, então leia ambos os lados antes de decidir qualquer coisa.

Puxe conhecimento útil para suas Fontes

Notas não se tornam Fontes automaticamente. Revise um rascunho antes de adicioná-lo à sua biblioteca. Você pode enviá-lo você mesmo ou autorizar um agente cujo Perfil tenha Envios ativados.

  1. Em cada nota que vale a pena manter, escolha Adicionar ao rascunho.
  2. Escolha Criar rascunho. O Takibi combina as notas selecionadas em um rascunho Markdown.
  3. Leia o rascunho e compare cada afirmação com os documentos que ele cita. Edite qualquer coisa que precise de correção.
  4. Escolha Copiar ou Baixar e envie a versão aprovada através de Documentos.

Para o resto da fila:

Manter
Endossa uma nota útil e a tira da fila; agentes ainda podem encontrá-la. Não torna a nota uma Fonte, não resolve suas sinalizações de conflito nem estende sua vida útil.
Remover
Impede que agentes vejam a nota imediatamente. Não há desfazer, então leia a nota primeiro.

Saiba o que permanece temporário

Toda nota expira 30 dias após ser criada. Manter uma nota ou procurá-la novamente não reinicia esse relógio. Qualquer coisa que valha a pena manter por mais tempo pertence a uma Fonte.

Uma nota que conflita com outra nota carrega uma sinalização ligando ambos os lados — notas sinalizadas ficam na pesquisa de agentes e em rascunhos, então os leitores podem consultar ambas as afirmações. Apenas notas removidas ou expiradas ficam fora dos rascunhos. Se um rascunho relatar um conflito, verifique ambas as afirmações em relação às suas Fontes antes de decidir o que preservar.