Skip to main content
Sign in →

Inicio Rapido

Protege tus agentes de IA con ShieldAgent en menos de 5 minutos.

01Crea tu cuenta

Registrate en app.shieldagent.io para crear tu organizacion. Recibiras una clave de API en Configuracion → Claves de API.

Lo que necesitas:

  • • Tu Clave de API (desde Configuracion → Claves de API)
  • • Tu Tenant ID (visible en la pagina principal del panel)

02Registra un agente

Registra tu agente de IA en el panel (Agentes → Agregar Agente) o a traves de la API:

bash
curl -X POST https://api.shieldagent.io/api/v1/tenants/{your-tenant-id}/agents \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {your-api-key}' \
  -d '{
    "name": "coding-agent",
    "description": "VS Code Copilot integration"
  }'
# Response: {"id":"agt_...","name":"coding-agent","agentKey":"sa_live_..."}

Guarda el agentKey — tu agente lo usa para autenticarse con el proxy. Solo se muestra una vez.

03Apunta tu agente al proxy

Actualiza la configuracion MCP de tu agente para que pase por ShieldAgent en lugar de conectarse directamente al servidor MCP:

mcp-config.json
{
  "mcpServers": {
    "filesystem": {
      "url": "https://proxy.shieldagent.io/mcp",
      "headers": {
        "Authorization": "Bearer {agent-key}"
      }
    }
  }
}

Reemplaza {agent-key} con la clave de agente del paso 02.

04Verifica que funciona

Envia una llamada de herramienta de prueba a traves del proxy para confirmar que todo esta conectado:

bash
curl -X POST https://proxy.shieldagent.io/message \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {agent-key}' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "read_file",
      "arguments": { "path": "/workspace/README.md" }
    }
  }'
# Response: {"jsonrpc":"2.0","id":1,"result":{...}}

Abre el panel para ver tu primera llamada interceptada en el registro de auditoria.

05Crea tu primera politica

Bloquea llamadas peligrosas creando una regla de denegacion (Panel → Politicas → Agregar Regla, o via API):

bash
curl -X POST https://api.shieldagent.io/api/v1/tenants/{your-tenant-id}/policies \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {your-api-key}' \
  -d '{"toolName":"delete_file","action":"deny"}'
# Response: {"id":"pol_...","toolName":"delete_file","action":"deny"}

Ahora cualquier agente que invoque delete_file sera bloqueado, y el evento aparecera en tu registro de auditoria.

06Usa el SDK (opcional)

Para acceso programatico, usa los SDKs oficiales:

TypeScript

example.ts
import { ShieldAgentClient } from '@shieldagent/sdk';

const client = new ShieldAgentClient({
  apiKey: '{your-api-key}',
  baseUrl: 'https://api.shieldagent.io',
});

const agents = await client.agents.list({ tenantId: '{your-tenant-id}' });
const events = await client.audit.list({ tenantId: '{your-tenant-id}', limit: 50 });

Python

example.py
from shieldagent import ShieldAgentClient

client = ShieldAgentClient(
    api_key="{your-api-key}",
    base_url="https://api.shieldagent.io",
)

agents = client.agents.list(tenant_id="{your-tenant-id}")
events = client.audit.list(tenant_id="{your-tenant-id}", limit=50)

Proximos Pasos

Modo Shadow

Observa antes de aplicar

Motor de Politicas

Escribe reglas avanzadas

API de Veredicto

Analiza desde tu propio servidor

Inicio Rapido