Integración de agentes

Ciclo de vida del agente

En el panel

Registra y configura agentes sin escribir código:

1. 1Ve a Agentes en la barra lateral izquierda y haz clic en Añadir agente.
2. 2Introduce un nombre, una descripción opcional y elige un nivel de riesgo (bajo / medio / alto / crítico).
3. 3Haz clic en Crear. Copia la clave API que aparece — se muestra solo una vez.
4. 4En la página de detalle del agente, ve a Servidores MCP → Añadir servidor. Introduce la URL ascendente y una etiqueta.
5. 5Opcionalmente, activa el Modo sombra en el vínculo para observar el tráfico antes de aplicar políticas.

Registrar un agente

import ShieldAgent from '@shieldagent/sdk';

const client = new ShieldAgent();

const agent = await client.agents.create({
  name: "coding-agent",
  description: "Claude in VS Code via Cursor",
  riskTier: "medium",
});

{
  "id": "agt_01HXYZ...",
  "name": "coding-agent",
  "tenantId": "ten_01HXYZ...",
  "riskTier": "medium",
  "agentKey": "shld_agent_<token>"  // ← send this to your agent
}

Crear un vínculo MCP

Los vínculos asignan un agente a un servidor MCP ascendente. Puedes tener múltiples vínculos por agente (p. ej., sistema de archivos, base de datos, búsqueda web).

const binding = await client.agents.createBinding(agent.id, {
  upstreamUrl: "http://<your-mcp-server>:<port>",
  shadowMode: false,
  label: "filesystem",
});

Configuración multi-agente

Registra múltiples agentes por tenant, cada uno con su propia clave, nivel de riesgo y vínculos. Las políticas pueden tener alcance por agente o a nivel de tenant.

// Register a second agent (higher risk tier)
const opsAgent = await client.agents.create({
  name: "ops-agent",
  description: "Infrastructure automation agent",
  riskTier: "high",
});

// List all agents
const agents = await client.agents.list();

Rotación de credenciales

Rota la clave API de un agente sin tiempo de inactividad. La clave antigua permanece válida durante un breve periodo de gracia después de la rotación para permitir una transición ordenada.

const newKey = await client.agents.rotateKey(agent.id);