Documentação

Todos os guiasIA e privacidade

Agente de IA

Conecte seu provedor, escolha um modo e aceite apenas patches que você revisou.

5 min de leitura

Conecte seu próprio provedor

O agente usa a conta que você escolher: Claude por OAuth de assinatura, Codex e Grok por device code, ou um endpoint compatível com OpenAI ou Anthropic por chave e URL base.

Chaves e tokens ficam na Keychain. Não existe uma conta ou servidor Odete intermediando a solicitação; o pedido vai diretamente para o provedor selecionado.

Escolha o modo antes de pedir

Chat lê o projeto e responde sem editar. Plan grava somente .odete/plan.md, útil para organizar o trabalho. Build pode editar o projeto, sempre por patches que você pode revisar.

O agente pode ler arquivos, listar, buscar, consultar o terminal, executar comandos, substituir ou escrever conteúdo e conversar com a API do GitHub, conforme o modo e a permissão escolhidos.

  • Ask: peça aprovação nas ações sensíveis.
  • Auto: automatize dentro da permissão concedida.
  • Full: ainda pede confirmação para escrever em repositórios de outras pessoas.

Mantenha a revisão humana

Cada edição chega como patch. Aceite, rejeite ou aceite hunk por hunk e compare o resultado com os testes e o Preview. Um checkpoint é criado antes de cada turno para desfazer a última rodada.

Peça uma investigação ou um plano primeiro quando a mudança tocar várias partes do projeto. O agente não substitui revisão de segurança, testes de integração ou decisões de produto.

Entenda o contexto enviado

Ao enviar uma mensagem, seu texto, os arquivos que o agente solicitar e a saída de comandos necessária podem ser enviados ao provedor de IA. O código e a conversa seguem a política de privacidade desse provedor.

Conversas, patches, checkpoints e planos ficam em .odete/ no projeto e são excluídos do Git. Não envie segredos que o provedor não deva receber; reduza o contexto e revise permissões antes de usar Build.