Tu primera política

En el panel

La forma más rápida de crear tu primera política, sin llamadas a la API:

1. 1En el panel de ShieldAgent, ve a Políticas en la barra lateral izquierda.
2. 2Haz clic en Nueva política.
3. 3Establece el Nombre de herramienta (p. ej. read_file), la Acción en permitir y, opcionalmente, limita el alcance a un agente concreto.
4. 4Haz clic en Guardar — la política surte efecto automáticamente.

Todos los cambios se reflejan en el registro de auditoría. Usa el panel para iterar rápidamente; automatiza con la API para CI/CD o IaC.

Cómo se evalúan las políticas

Solo las solicitudes tools/call se comprueban con las políticas. Los demás métodos MCP (tools/list, resources/read) pasan sin revisión.

Permitir una herramienta

Permite a tu agente llamar a read_file en cualquier ruta:

import ShieldAgent from '@shieldagent/sdk';

const client = new ShieldAgent();

await client.policies.create({
  agentId: "<agent-id>",
  toolName: "read_file",
  action: "allow",
});

Denegar con una condición

Bloquea llamadas a bash que contengan rm -rf:

{
  "tenantId": "<tenant-id>",
  "agentId": "<agent-id>",
  "toolName": "bash",
  "action": "deny",
  "conditions": [
    {
      "type": "param_contains",
      "param": "arguments.command",
      "value": "rm -rf"
    }
  ]
}

Todas las condiciones usan lógica AND — cada condición debe coincidir para que la regla se aplique. Si una condición falla, el evaluador pasa a la siguiente regla.

Política a nivel de tenant

Establece agentId en null para aplicar la regla a todos los agentes del tenant. Las reglas específicas por agente siempre prevalecen sobre las reglas a nivel de tenant.

{
  "tenantId": "<tenant-id>",
  "agentId": null,
  "toolName": "tools_list",
  "action": "allow"
}

Acciones de política