Guia do Colaborador — CRP.AI

Este guia explica como configurar o ambiente local para usar o CRP.AI, consultar sua virtual key, atualizar a configuração e resolver problemas comuns.

1. CRP.AI Installer

O CRP.AI Installer configura automaticamente seu ambiente para usar inteligência artificial pela plataforma corporativa. Durante a execução, você autentica sua identidade e salva a configuração necessária para começar.

O que ele faz

1. Verifica se o OpenCode está instalado e oferece instalação automática se necessário
2. Autentica sua identidade via login corporativo no navegador
3. Obtém sua virtual key para os modelos de IA disponíveis ao seu time
4. Configura o OpenCode com os providers, modelos, Base URLs e virtual keys recebidos
5. Oferece a instalação da CRP.AI Skill do catálogo corporativo, quando disponível
6. Oferece a configuração do MCP Azure DevOps quando houver PAT provisionado e você confirmar a operação
7. Exibe um resumo da configuração aplicada

O Installer registra um plugin do CRP.AI no OpenCode. Ele pode identificar ausência de configuração em instalações globais, mas a verificação de configuração desatualizada não substitui a atualização manual. Execute o Installer após regenerar uma chave, mudar de máquina ou receber alteração de modelos permitidos.

2. Instalação Passo a Passo

2.1 Pré-requisitos

• Node.js versão 20 ou superior (node --version)
• Registro npm interno configurado para o pacote @crp/crp-ai
• Navegador para o login corporativo
• Conexão com a rede corporativa ou VPN da CRP

2.2 Configurar o Registro npm

O CRP.AI Installer é distribuído pelo registro npm interno da CRP (Nexus). Antes da primeira execução, configure o npm para usar o registro corporativo no escopo @crp:

npm config set @crp:registry https://nexus.fabricacrp.com.br/repository/crp-ai/

Esta configuração é salva no arquivo ~/.npmrc e só precisa ser feita uma vez. Se o registro exigir autenticação, solicite a configuração ao time responsável.

2.3 Instalar

Abra o terminal e execute:

npx @crp/crp-ai@latest

A flag @latest garante que você sempre use a versão mais recente do Installer. Se preferir, apenas npx @crp/crp-ai também funciona.

Opcionalmente, use --local para salvar a configuração no diretório atual em vez do diretório global.

2.4 Etapas

Etapa 1 — Ambiente: o Installer verifica se o OpenCode está instalado. Se não estiver, oferece instalação automática.

Etapa 2 — Autenticação: o terminal exibe uma URL e um código para login corporativo. O Installer tenta copiar o código para a área de transferência; use o código exibido caso essa cópia não esteja disponível. O processo expira em 5 minutos.

Etapa 3 — Virtual key: após a autenticação, o Installer obtém a chave de API e as configurações do seu time.

Etapa 4 — Skill e Azure DevOps: o Installer pode oferecer a instalação da @crp/skill-crp-ai a partir do Nexus e, quando houver um PAT provisionado, a configuração opcional do MCP Azure DevOps.

Etapa 5 — Finalização: o Installer salva a configuração e exibe um resumo do que foi configurado.

3. Uso Diário

3.1 Consumir IA

Após a configuração, os providers e modelos disponíveis aparecem na lista do OpenCode com o rótulo recebido na configuração do seu acesso. Você pode alternar entre modelos com o comando /model.

3.2 Manutenção

Se sua chave for regenerada ou novos modelos forem adicionados ao seu time, execute o Installer novamente para atualizar a configuração local.

Execute npx @crp/crp-ai@latest a qualquer momento para:

• Atualizar a lista de modelos
• Atualizar credenciais após regeneração de chave
• Reconfigurar o ambiente após trocar de máquina

O Installer combina providers e entradas MCP por identificador, mas uma nova execução pode substituir a configuração do plugin CRP.AI e a entrada azure-devops do MCP. Revise configurações locais personalizadas antes de executá-lo novamente.

4. Responsabilidade sobre Código Gerado por IA

O uso de IA não transfere a responsabilidade técnica pelo código. Toda sugestão gerada por IA deve ser revisada, testada e ajustada conforme os padrões do projeto e da empresa.

Os princípios e as responsabilidades que orientam esse uso estão no Modelo de Governança do Desenvolvimento Assistido.

O código é seu

Toda linha de código gerada ou sugerida por IA deve ser tratada como uma contribuição sob sua responsabilidade. Isso significa que você precisa:

• Entender o que o código faz: revise a sugestão antes de incorporá-la
• Decidir a abordagem: adapte ou descarte sugestões que não se alinhem às práticas do time, do projeto ou da empresa
• Manter domínio do código: entregue apenas código que você consiga explicar, manter e corrigir

Siga as convenções da empresa

O código gerado por IA deve respeitar os mesmos padrões que você aplicaria ao seu próprio código:

• Padrões de código e arquitetura definidos pelo time
• Decisões registradas na documentação de arquitetura do CRP.AI
• Diretrizes estabelecidas pelo time de arquitetura da empresa

A CRP.AI Skill organiza o fluxo de Azure DevOps — branches, Draft PRs e documentos de trabalho — mas não escolhe nem executa a metodologia de desenvolvimento. As decisões de como implementar, que abordagem seguir e qual código entregar são sempre suas.

5. Minha Chave

5.1 Acessando

Acesse o Olimpo e navegue até CRP.AI > Minha Chave.

5.2 Informações Disponíveis

Informação	Descrição
Modelos disponíveis	Quais modelos de IA seu time pode usar
Orçamento vigente	Regra de orçamento aplicada à sua chave conforme a configuração do seu time
Consumo atual	Quanto já foi registrado no período
Data de reset	Quando o orçamento será renovado
Status da chave	Se sua chave está ativa, bloqueada ou revogada

5.3 Regenerar Chave

Se você suspeitar que sua chave foi comprometida:

1. Na página Minha Chave, clique em Regenerar Chave
2. Confirme a ação
3. Execute npx @crp/crp-ai para atualizar sua configuração local

A regeneração não afeta seu histórico de consumo. A chave anterior é invalidada imediatamente.

6. Configurar Outras Ferramentas

O CRP.AI pode ser usado com ferramentas compatíveis com a interface OpenAI API exposta pelo gateway, como Cursor, Continue, Aider e Zed, desde que a configuração necessária seja suportada.

Trate ~/.config/opencode/opencode.json como configuração local confidencial. O Installer também pode criar ~/.config/opencode/.azure-devops-mcp.env para o MCP Azure DevOps. Esses arquivos podem conter, respectivamente, virtual keys e um PAT; não os compartilhe, não os registre em repositórios, tickets ou mensagens. Evite --local para essa configuração; se ele for indispensável, confirme que opencode.json e .azure-devops-mcp.env estão ignorados pelo Git antes de continuar.

Para configurar outra ferramenta, localize a seção do provider e use a API Key e a Base URL recebidas para a virtual key nos campos equivalentes. A Base URL pode variar por entrada de configuração; não a substitua por um endpoint externo. Se a ferramenta não aceitar essa configuração, use apenas o OpenCode ou solicite orientação ao administrador.

7. Problemas Comuns

Autenticação

Problema	Solução
Código de acesso expirou	Execute npx @crp/crp-ai novamente
Navegador não abriu	Copie a URL exibida no terminal e abra manualmente
Não consegue autenticar	Verifique se está na rede corporativa ou VPN

Chave não Funciona

Problema	Solução
Chave desatualizada	Execute npx @crp/crp-ai para atualizar
Acesso removido	Verifique o status em CRP.AI > Minha Chave; contate o administrador se necessário
Orçamento excedido	Aguarde o reset do período ou solicite aumento ao administrador
Modelo não autorizado	Verifique quais modelos estão disponíveis na Minha Chave

Outros

Problema	Solução
Modelo não aparece	Execute npx @crp/crp-ai para atualizar a lista
Conexão recusada	Verifique se está na rede corporativa ou VPN
Mensagem "CRP AI is not set up yet"	Execute npx @crp/crp-ai
Mensagem "setup needs updating"	Execute npx @crp/crp-ai para atualizar
npx não encontra o pacote @crp/crp-ai	Verifique se o registro npm interno está configurado (seção 2.2) e se está na rede corporativa ou VPN

---

Precisa de ajuda que não está neste guia? Entre em contato com o administrador do seu time.