Guia do Administrador — CRP.AI

Guia operacional para administradores do módulo CRP.AI no Olimpo. Ele cobre a configuração de acesso dos times, os limites de consumo e o acompanhamento administrativo do uso.

Antes de Começar

Use este guia apenas para operações de governança no Olimpo: acesso, times, modelos permitidos, budgets e solicitações do ciclo de vida de chaves de usuários. Configuração de provedores, credenciais de provedores, modelos registrados, roteamento técnico, spend logs brutos, diagnóstico de runtime e recuperação do AI Gateway são responsabilidades da equipe que opera o gateway. Antes de configurar um time, confirme quais modelos já estão disponíveis e qual política de limite de consumo deve ser aplicada.

1. Acesso ao Painel

Acesse o Olimpo com seu login corporativo. Após entrar, o menu CRP.AI estará disponível na barra lateral. As funcionalidades que você vê dependem do seu perfil de acesso:

• Administrador: gerencia times, define modelos permitidos, aplica limites de consumo e controla o acesso a IA
• Colaborador: visualiza e gerencia apenas sua própria virtual key

Se o menu CRP.AI não aparecer, solicite ao time de infraestrutura a liberação do seu acesso.

2. Gestão de Times

Cada time representa um grupo de colaboradores que compartilham as mesmas regras de acesso à IA. Os times são originados do Controle de Projetos e aparecem automaticamente no CRP.AI.

2.1 Visualizar Times

No menu CRP.AI > Times, você vê a lista de todos os times com:

• Nome do time
• Quantidade de membros
• Status (ativo ou inativo)

Use a busca para localizar um time específico. Por padrão, apenas times ativos são exibidos.

2.2 Configurar um Time

Ao clicar no nome de um time, você acessa a tela de detalhes com duas áreas:

Configuração de IA (lado esquerdo): define quais modelos o time pode usar e quais regras de limite de consumo serão aplicadas às virtual keys dos colaboradores. O acesso à IA do time pode ser ativado ou desativado. A configuração exige ao menos um modelo e um limite de consumo definidos.

Lista de Membros (lado direito): mostra os colaboradores do time e permite ativar ou desativar o acesso a IA individualmente.

2.3 Ativar e Desativar Acesso

• Ativar para o time: os membros passam a seguir a regra padrão de acesso configurada para o time
• Desativar para o time: bloqueia a regra padrão de acesso do time
• Ativar/desativar por membro: permite exceções individuais quando o processo operacional exigir

A configuração do time define a regra padrão de acesso. A configuração do membro permite exceções individuais quando o processo operacional exigir. Quando o acesso individual é desativado, a chave do colaborador deixa de funcionar mesmo que o time esteja ativo.

A desativação não remove o time nem os membros; ela solicita ao AI Gateway o bloqueio do acesso técnico associado aos colaboradores afetados.

3. Configuração de Modelos

Cada time pode ter um conjunto específico de modelos de IA autorizados entre os modelos já disponibilizados pelo AI Gateway. Para configurar:

1. Acesse CRP.AI > Times e clique no time desejado
2. Clique em Editar configuração
3. Selecione os modelos permitidos na lista disponível
4. Defina o limite de consumo aplicado às virtual keys dos colaboradores (em dólares)
5. Salve

Após salvar, o módulo CRP.AI registra a política e solicita a atualização correspondente ao AI Gateway para os membros do time que possuem acesso à IA ativo.

4. Controle de Limite de Consumo

O limite de consumo (budget) é configurado no contexto do time como política corporativa. O módulo CRP.AI envia os parâmetros ao AI Gateway, que os aplica ao consumo por meio das virtual keys. Quando houver limite individual, ele se aplica à chave do colaborador dentro das regras do time. Ao atingir o limite configurado, o AI Gateway pode bloquear a chave até o próximo ciclo.

4.1 Acompanhar Consumo

O portal Olimpo apresenta o contexto administrativo disponível para acompanhamento de consumo. Cada colaborador também consulta seu consumo individual na seção Minha Chave. Dashboards nativos, spend logs brutos e diagnóstico de runtime do AI Gateway pertencem à operação técnica do gateway.

4.2 Indicadores de Consumo

O sistema exibe indicadores visuais conforme o consumo se aproxima do limite:

• Verde: consumo normal (até 70%)
• Amarelo: atenção (70% a 90%)
• Vermelho: crítico (acima de 90%)

4.3 Quando o Limite For Excedido

Se um colaborador atingir o limite aplicado pelo AI Gateway:

• O gateway pode bloquear a virtual key conforme a configuração.
• Para liberar, revise o limite na configuração do time ou aguarde o próximo ciclo.

5. Gerenciamento de Chaves

Cada colaborador com acesso a IA recebe uma virtual key individual. Essa chave de API é usada em ferramentas de IA e está vinculada ao colaborador para fins de controle e rastreabilidade.

5.1 Como o Colaborador Obtém a Chave

O colaborador instala a ferramenta CRP.AI Installer em sua máquina, que:

1. Autentica sua identidade corporativa
2. Obtém a virtual key vinculada ao seu time
3. Configura as ferramentas de IA para uso imediato

5.2 Regenerar Chave

Se um colaborador suspeitar que sua chave foi comprometida, ele pode solicitar a regeneração pelo portal Olimpo. O módulo CRP.AI solicita a operação ao AI Gateway, que invalida a chave anterior e gera a nova credencial. O histórico de consumo é preservado conforme o estado mantido pelo gateway.

5.3 Bloquear Acesso de um Colaborador

Para bloquear o acesso de um colaborador específico:

1. Acesse o time no menu CRP.AI > Times
2. Localize o colaborador na lista de membros
3. Desative o acesso à IA

6. Acompanhamento de Custos

O portal Olimpo é a interface de governança e acompanhamento administrativo do CRP.AI. Dashboards nativos do AI Gateway são usados por operadores técnicos para dados operacionais brutos, não como substitutos da administração de acesso no Olimpo.

6.1 Auditoria

As ações administrativas relevantes ficam registradas para auditoria, incluindo alterações em times, modelos permitidos, orçamentos e solicitações de operação sobre chaves. Os dados operacionais de consumo são mantidos pelo AI Gateway e podem ser apresentados no Olimpo conforme o contexto disponível.

7. Problemas Comuns

Situação	O que fazer
Colaborador não tem acesso à IA	Verifique se o time está com acesso à IA ativo e se o membro não está bloqueado individualmente
Colaborador não vê um modelo específico	Verifique se o modelo está na lista de permitidos do time
Chave bloqueada por limite de consumo	Revise o limite do time ou oriente o colaborador a aguardar o próximo ciclo
Menu CRP.AI não aparece	Solicite liberação de acesso ao time de infraestrutura
Modelo novo não aparece na lista	O time de infraestrutura precisa configurar o modelo no AI Gateway primeiro