Inteligência artificial
Provedores, chaves e limites da IA da organização.
Consultar configuração de IA da organização
Mostra os provedores de IA e a rota primária/contingência da organização atual. Requer a permissão `ai.settings.read`. A resposta traz só metadados (provedor configurado, últimos quatro caracteres, plano que definiu, datas, rota e modelos sugeridos); a chave armazenada nunca é devolvida.
Definir chave de API do provedor de IA
Requer a permissão `ai.settings.manage` e uma pessoa autenticada (chaves de API recebem `403`). Envia `api_key` (somente escrita), que é criptografada na hora e substitui a anterior do mesmo provedor (`openai`, `anthropic`, `xai` ou `gemini`). Registra auditoria e devolve os metadados atualizados, sem a chave.
Remover chave de API do provedor de IA
Requer a permissão `ai.settings.manage` e uma pessoa autenticada (chaves de API recebem `403`). Remove a chave do provedor. Se o provedor estiver na rota primária ou de contingência, retorna `409` `ai_provider_in_use`. Devolve os metadados atualizados.
Testar chave de API do provedor de IA
Requer a permissão `ai.settings.manage` e uma pessoa autenticada (chaves de API recebem `403`). Usa a chave cadastrada para listar os modelos do provedor e responde com `ok`, `reason` (`ok`, `key_rejected` ou `unreachable`) e `models`. Sem chave cadastrada retorna `409` `ai_provider_not_configured`; limite de 10 testes a cada 10 minutos por pessoa (`429`).
Definir rota de IA da organização
Requer a permissão `ai.settings.manage` e uma pessoa autenticada (chaves de API recebem `403`). O corpo traz `primary_provider`/`primary_model` e, opcionalmente, `fallback_provider`/`fallback_model`; provedor e modelo andam juntos, e primário nulo desliga a IA. Cada provedor da rota precisa ter chave cadastrada (senão `409` `ai_provider_not_configured`). Concorrência otimista por `expected_version` (`0` quando ainda não havia rota): versão divergente retorna `409` `ai_settings_conflict`.