# Cofre para IA

> Contrato do piloto sintético. O artefato web exige API com Keycloak real antes de publicação. Não envie credenciais reais para este domínio ou repositório.

O Cofre para IA permite que agentes peçam operações autorizadas a provedores sem receber o valor da credencial.

## Documentos

- [Arquitetura](docs/arquitetura.md): fronteira entre cliente, API, broker e OpenBao.
- [Contrato de API](docs/openapi.yaml): catálogo, invocação e recibo do piloto sintético.
- [Painel do piloto](docs/painel-piloto.md): login humano, execução e limites.

## Limites para agentes

- Use apenas a API publicada e identidades emitidas para sua organização.
- Descubra capacidades no catálogo. Execute somente operações listadas e autorizadas.
- IDs de conexão e de operação não concedem acesso por si mesmos.
- Nunca peça, imprima ou registre o valor de uma credencial.
- Não tente usar o serviço como proxy HTTP livre ou executor de comandos.
- Confirme efeitos e falhas pelo estado e pelo recibo da operação.