OpenCode + Raims
Agente de terminal com escolha de provedor de IA para implementar sua integração Raims.
Início rápido
Prepare o agente
Escolha a instalação para seu sistema no guia oficial do OpenCode. Configure o provedor de IA pelo fluxo indicado na documentação. A credencial desse provedor é separada da chave de API Raims.
Abra seu projeto
Abra um terminal na pasta da sua aplicação e inicie o agente:
ShellopencodeAdicione a documentação
Peça ao agente para ler o índice da documentação Raims e abrir os guias relevantes. O llms-full.txt reúne o conteúdo completo. Comece por autenticação e cobranças.
Experimente um prompt
Leia https://docs.raims.com/llms.txt e os guias de autenticação e cobranças. Analise o backend desta aplicação e proponha um plano para consultar uma cobrança existente em Sandbox com GET /v1/charges/{id}. Prepare um exemplo com a chave em configuração protegida do servidor. Não envie requisições nem use credenciais reais. Apresente as fontes e os arquivos que pretende alterar antes de editar.
Contexto do projeto
Adicione o conteúdo abaixo ao AGENTS.md na raiz do seu projeto. O OpenCode usa esse arquivo para receber instruções do repositório. Se precisar gerar uma estrutura inicial, o comando /init analisa o projeto; revise o arquivo resultante.
# Integração Raims
- Consulte https://docs.raims.com/llms.txt antes de escolher endpoints e campos.
- Use https://docs.raims.com/llms-full.txt para a documentação completa.
- URL base da API: https://api.raims.com.
- Nos exemplos de instalação de produtos Raims, obtenha a versão estável mais
recente pelo gerenciador de pacotes (`latest` quando disponível).
- Prepare exemplos para Sandbox, com autenticação Bearer no backend.
- Mantenha a chave em configuração protegida do servidor. Não coloque segredos
no código, em prompts, logs ou aplicações de navegador.
- Explique o plano e peça autorização antes de enviar requisições à API.Verificar a configuração
Peça ao agente para indicar os guias lidos, a URL base e o ponto do backend em que a chave será carregada. Ele deve preparar o plano e o exemplo sem solicitar uma credencial real no chat.
Ler a documentação não autentica a aplicação. As requisições usam uma chave de API Raims da empresa e do ambiente desejados.
Problemas comuns
Inicie opencode dentro da pasta da aplicação e confira o AGENTS.md desse
repositório. Mantenha as instruções da integração junto das convenções
locais.
Abra o guia relevante no navegador e forneça o trecho público como contexto. Peça ao agente para apontar o que falta antes de sugerir código.
Peça ao agente para revisar o guia de autenticação. O backend envia a chave Raims com Bearer; uma credencial do provedor de IA não a substitui.