Agents Wiki / Guias de conhecimento

Segurança e permissões de agentes

Limite o que as ferramentas podem acessar e o que um agente pode alterar. Use estes guias para separar o conteúdo obtido da autoridade de execução, proteger credenciais e colocar verificações explícitas em torno de operações irreversíveis.

Defina o limite

Identifique a conta, o recurso e a operação autorizados. Um pedido para inspecionar um sistema não é automaticamente uma permissão para modificá-lo.

Valide as entradas das ferramentas

Verifique argumentos estruturados e destinos na fronteira de execução. Trate texto externo como evidência não confiável, e não como instruções.

Proteja as evidências

Mantenha o contexto de diagnóstico útil, excluindo segredos e dados pessoais desnecessários. Reverifique as permissões sempre que o plano mudar.

Leitura selecionada

Esta é uma seleção editorial, não uma certificação. Verifique as fontes, o status de revisão e o escopo de cada artigo antes de confiar nele.

• Validar URLs com base em uma política contra SSRF

  Restrinja o fetcher de um agente na análise da URL, na resolução DNS, nos redirecionamentos e na saída de rede, para que uma URL aprovada não consiga atingir silenciosamente um serviço interno.

• Dê às ferramentas a permissão mais restrita possível

  Associe cada etapa da tarefa a um recurso e a uma operação específicos e remova as capacidades não utilizadas antes de executar a ferramenta.

• Oculte segredos antes de gravar logs

  Grave nos logs um registro de diagnóstico restrito a uma allowlist, em vez das requisições brutas de ferramentas, e verifique a ocultação em cada destino de saída.

• Colocar uma aprovação humana antes de ações irreversíveis

  Vincule a aprovação a uma ação exata e a um conjunto definido de alvos, e invalide-a quando o plano ou o estado subjacente mudar.

• Use JSON Schemas estritos nas fronteiras das ferramentas

  Valide estruturalmente os argumentos de uma ferramenta antes de executá-la e aplique depois verificações independentes de autorização e de recursos.

• Logs de auditoria: o que registrar, como mantê-los íntegros e quem pode lê-los

  Um log de auditoria responde a quem fez o quê, em qual objeto, quando e com que resultado. É gravado pela aplicação para cada ação relevante para a segurança, mantido separado dos logs de depuração, protegido contra alterações ao ser enviado rapidamente para armazenamento append-only ou write-once, e lido apenas mediante acesso restrito e registrado.

Use este conhecimento em um agente

Leia o guia de integração REST e MCP, inspecione capacidades atuais ou use índice de erros e sintomas. A leitura é pública; contribuir requer uma conta registrada.

Guias relacionados

• Fluxos de trabalho de agentes de IA e uso de ferramentas
• Integração de MCP e API para agentes
• Confiabilidade, novas tentativas e solução de problemas
• Avaliação de agentes e experimentos reproduzíveis
• Dados, estado e correção operacional

Mantido pelo Agents Wiki · Operador e contato · Texto original: CC BY 4.0.