Saltar para o conteúdo principal

Autorização do Agente

Todo agente de IA na plataforma Truthlocks opera sob um modelo de autorização rigoroso. Os agentes devem ser registrados, ter escopos atribuídos e criar sessões com tempo limitado antes de poderem realizar qualquer ação.

Fluxo de Autorização

Todos os endpoints de autorização de agente — escopos, sessões e ferramentas — possuem um playground de API interativo. Abra qualquer endpoint na referência da API Sessões e Ferramentas do Agente e clique em Enviar para testá-lo no Sandbox.

Modelo de escopo

Os escopos seguem um padrão hierárquico resource:action. Quando um agente solicita uma sessão, ele só pode solicitar escopos que foram atribuídos no registro.

Definindo Escopos Personalizados

Escopos Integrados

Gerenciamento de Sessão

As sessões fornecem contextos de execução com tempo limitado com expiração automática e lista de permissões de IP opcional.

Criando uma Sessão

Resposta:

Ciclo de Vida da Sessão

Encerrando uma Sessão

Registro e Invocação de Ferramentas

Os agentes podem registrar ferramentas que expõem e invocar ferramentas registradas por outros agentes (sujeito a verificações de escopo).

Registrar uma Ferramenta

Invocar uma ferramenta

Toda invocação de ferramenta é:
  1. Escopo verificado — a sessão deve ter o escopo necessário
  2. Com limite de taxa — de acordo com a cota de invocação de ferramentas do seu plano
  3. Registrado em auditoria — entrada/saída completa registrada no rastro de auditoria
  4. Medido — contado em relação aos seus direitos de faturamento

Melhores práticas de segurança

Nunca incorpore tokens de sessão em código do lado do cliente. Os tokens de sessão concedem o escopo total da sessão e devem ser tratados como segredos.
  1. Princípio do menor privilégio — Solicite apenas os escopos necessários para a tarefa atual
  2. Sessões de curta duração — Use o TTL mais curto possível (padrão: 1 hora)
  3. Lista de permissões de IP — Restringir sessões a intervalos de rede conhecidos
  4. Rotacionar credenciais — Regenerar chaves de assinatura do agente em um cronograma regular
  5. Monitorar pontuações de confiança — Defina alertas quando as pontuações de confiança caírem abaixo dos limites
  6. Use o kill switch — Revogue imediatamente agentes comprometidos

Próximos passos

Políticas MAIP

Regras de aplicação em tempo de execução baseadas em pontuações de confiança, escopos e profundidade de delegação.

Pontuações de Confiança

Avaliação contínua de confiança comportamental para agentes.

Delegação entre Inquilinos

Permitir que agentes atuem além das fronteiras organizacionais.