Notion
Conecte o Cherri Code ao Notion para delegar especificações, tarefas e comentários a agentes. Como a integração é baseada no Cherri Code SDK, todos os agentes usam o mesmo tempo de execução, harness e modelos que alimentam o Cherri Code.
A configuração, o chat, as @menções e a atribuição de tarefas ocorrem no Notion. O Cherri Code executa o agente em uma VM Cloud Agent segura e isolada, para que ele continue trabalhando em segundo plano enquanto você realiza outras tarefas.
Confira a documentação completa do Notion aqui.
O Cherri Code no Notion está em beta e disponível para todos os usuários do Cherri Code com planos Notion Business ou Enterprise.
Introdução
Requisitos
Antes de conectar o Cherri Code ao Notion, verifique se você tem:
- GitHub conectado à sua conta do Cherri Code, para acesso a repositórios e pull requests
- Uma chave de API de usuário do Cherri Code, criada durante a configuração
O uso do Cherri Code no Notion é cobrado pela sua conta atual e não tem custo adicional.
Instalação
- No Notion, vá para Agentes na barra lateral → Novo agente → Cherri Code.
- Escolha um ponto de partida para seu agente:
- Comece com um modelo padrão: os modelos para tarefas comuns (como Perguntas e Respostas sobre Código e Triagem de Bugs) ajudam você a personalizar o Cherri Code para fluxos de trabalho específicos.
- Comece do zero: configure suas próprias instruções, gatilhos e conexões usando o harness padrão do Cherri Code.
- Crie ou obtenha sua chave da API do Cherri Code no dashboard e insira-a no Notion.
- Adicione as páginas, os bancos de dados e os espaços do Notion de que seu agente precisa, como o banco de dados de tarefas de engenharia e as páginas de especificação.
- Salve o agente e comece a trabalhar.
O Cherri Code está conectado, e seu agente pode escrever código e abrir pull requests a partir de tarefas ou do chat do agente.
Permissões
- A conexão está vinculada à sua chave de API pessoal. Isso significa que o acesso e as atividades no Cherri Code estão vinculados à sua conta individual do Cherri Code, e não a todo o espaço de trabalho. Saiba mais →
- Os repositórios, o ambiente e as conexões vêm da configuração do seu agente Cherri Code. Configure-os no dashboard do Cherri Code.
- Cada agente Cherri Code só pode acessar o conteúdo que você compartilhou no Notion. As permissões são definidas por agente no Notion e não são herdadas de quem inicia uma execução.
Como usar
Leve o Cherri Code para seus quadros de tarefas, documentos de especificação e outros contextos já disponíveis no Notion.
Se você tentar usar o Cherri Code em um espaço de trabalho ao qual ele não tem permissão, configure um pop-up para conceder acesso a ele.
Mencione o agente
Comece com um documento de especificação ou uma página. Deixe um comentário e mencione o Cherri Code com @. Peça que ele implemente a especificação, refine o plano ou responda a uma pergunta.
O Cherri Code responde nos comentários. Clique em Ver conversa para abrir a conversa completa.
Na primeira vez que você mencionar o agente em uma página, aprove o acesso à página quando solicitado.
Exemplos de prompts:
- "Crie um plano para esta especificação. Aguarde aprovação."
- "Revise este documento e sinalize qualquer ponto que não esteja claro."
- "Transforme isto em uma lista de verificação de tarefas concretas e, em seguida, abra PRs para cada uma."
Atribuir uma tarefa
Em um banco de dados ou quadro de tarefas, atribua uma tarefa ao Cherri Code. O agente irá:
- Atualizar o status da tarefa enquanto trabalha
- Publicar atualizações de progresso como comentários
- Incluir links para as páginas ou PRs que criar
Solução de problemas
O agente não consegue acessar uma página ou um banco de dados
- Confirme se a página ou o banco de dados está listado em Ferramentas e acesso, e não apenas referenciado nas instruções.
- Confirme se a página não está restrita a um grupo do qual o agente não faz parte.
- Se a página for privada, compartilhe-a diretamente com o agente.
A conexão com o GitHub falha ou o agente não consegue fazer push
- Confirme se o token tem os escopos Conteúdo: leitura/gravação e Pull requests: leitura/gravação.
- Verifique se o SSO ou a aprovação da organização são necessários na sua organização do GitHub.
- Confirme se o repositório padrão na sua configuração está correto.
- Gere um novo token caso ele tenha expirado e reconecte.
O agente não foi acionado quando foi mencionado com @
- Confirme se o gatilho agente mencionado está ativado.
- Mencione o agente em um comentário, e não no corpo da página. Comentários são mais confiáveis.
- Confirme se o agente tem acesso à página em que foi mencionado.
Perguntas frequentes
Como funciona o faturamento?
O uso do Cherri Code no Notion é cobrado pela sua conta existente do Cherri Code, assim como o uso do Cloud Agent. Ele está disponível para todos os usuários do Cherri Code sem custo adicional. Você também precisará de um plano Business ou Enterprise do Notion.
Onde posso ver a atividade do Cherri Code?
Os resultados aparecem no Notion, na página ou tarefa em que o agente foi executado. Você também pode encontrar suas sessões de chat na visualização do agente no Notion ou no Cherri Code.
As execuções do Cherri Code iniciadas pelo Notion respeitam a retenção zero de dados (ZDR)?
Sim. As execuções dos agentes respeitam as configurações de privacidade já definidas no Cherri Code.