Integración de agentes

Registra agentes de IA, aprovisiona claves API y configura vínculos MCP a través de ShieldAgent.

Ciclo de vida del agente

1Registrar agentePanel: Agentes → Añadir agente

2Copiar clave APISe muestra una vez tras la creación — añadir a la configuración

3Añadir servidor MCPPanel: página del agente → Servidores MCP → Añadir servidor

4Escribir políticasPanel: Políticas → Nueva política

5Enrutar tráficoEl agente se conecta al endpoint del proxy

6Monitorizar y auditarPanel: Resumen, Registro de auditoría, Radar de agentes

En el panel

Registra y configura agentes sin escribir código:

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

Vía API REST

Registrar un agente

Los ejemplos de SDK se han retirado. Para integrar ShieldAgent, usa la referencia OpenAPI.

Respuesta

json

{
  "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).

Los ejemplos de SDK se han retirado. Para integrar ShieldAgent, usa la referencia OpenAPI.

Modo sombra

Establece shadowMode: true para registrar todo el tráfico de este vínculo sin aplicar la política. Útil para observar el comportamiento del agente antes de escribir políticas.

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.

Los ejemplos de SDK se han retirado. Para integrar ShieldAgent, usa la referencia OpenAPI.

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.

Los ejemplos de SDK se han retirado. Para integrar ShieldAgent, usa la referencia OpenAPI.

Niveles de riesgo

Nivel	Caso de uso	Aplicación
low	Agentes internos de confianza, solo lectura	Permisivo — solo monitorización
medium	Agentes de desarrollo estándar	Evaluación de políticas estándar
high	Agentes con acceso de escritura/ejecución	Estricto + disparadores de revisión humana
critical	Infra prod, acceso financiero/PII	Bloqueo automático de anomalías, revisión obligatoria