Saltar al contenido principal Saltar a navegación Saltar al pie de página

Integración de agentes de IA - Descripción general

Cómo Claude Code, Cursor y Cline gestionan la infraestructura Rediacc mediante rdc: salida JSON, introspección del agente y medidas de seguridad.

rdc está diseñado pensando en los agentes. Claude Code, Cursor, Cline: cualquier asistente de IA que llame a rdc desde un subshell obtiene salida JSON estructurada, errores legibles por máquina y las medidas de seguridad necesarias para gestionar infraestructura Rediacc de forma autónoma. Así es como funciona la integración.

Por qué autoalojamiento + agentes de IA

La arquitectura de Rediacc se adapta bien a los agentes:

  • CLI primero: Cada operación es un comando rdc, no se requiere GUI
  • Basado en SSH: El protocolo que los agentes mejor conocen de los datos de entrenamiento
  • Salida JSON: Todos los comandos admiten --output json con un sobre consistente
  • Aislamiento Docker: Cada repositorio tiene su propio daemon y espacio de nombres de red
  • Automatizable: --yes omite confirmaciones, --dry-run previsualiza operaciones destructivas

Enfoques de integración

1. Plantilla AGENTS.md / CLAUDE.md

La forma más rápida de empezar. Copie nuestra plantilla AGENTS.md en la raíz de su proyecto:

  • CLAUDE.md para Claude Code
  • .cursorrules para Cursor
  • .windsurfrules para Windsurf

Añádala al proyecto y el agente dispondrá de la referencia completa de comandos, el contexto de arquitectura y las convenciones que necesita para trabajar sin tener que adivinar.

2. Pipeline de salida JSON

Cuando los agentes llaman a rdc en un subshell, la salida cambia automáticamente a JSON (detección non-TTY). Cada respuesta JSON utiliza un sobre consistente:

{
  "success": true,
  "command": "machine query",
  "data": { ... },
  "errors": null,
  "warnings": [],
  "metrics": { "duration_ms": 42 }
}

Las respuestas de error incluyen los campos retryable y guidance:

{
  "success": false,
  "errors": [{
    "code": "NOT_FOUND",
    "message": "Machine \"prod-2\" not found",
    "retryable": false,
    "guidance": "Verify the resource name with \"rdc machine status\" or \"rdc repo list\""
  }]
}

Opciones clave para agentes

OpciónPropósito
--output json / -o jsonSalida JSON legible por máquina
--yes / -yOmitir confirmaciones interactivas
--quiet / -qSuprimir la salida informativa en stderr
--fields name,statusLimitar la salida a campos específicos
--dry-runPrevisualizar operaciones destructivas sin ejecutar

Seguridad y medidas de protección

El CLI no trata a los agentes igual que a un humano en el terminal. Las operaciones sensibles requieren demostrar que ya se conoce el estado actual (mediante el flag --current), los flujos con editor interactivo se rechazan por defecto, y cada rechazo queda registrado en el log de auditoría. La referencia Seguridad y medidas de protección para agentes de IA incluye la tabla completa de restricciones, el modelo de verificación de conocimiento previo, el permiso REDIACC_ALLOW_CONFIG_EDIT y el log de auditoría con cadena de hashes.

Próximos pasos