lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

sistema intermedio agentesseguridadpythonlangchain

Adrian: inspecciona las acciones de agentes durante su ejecución

Observa razonamiento y uso de herramientas para aplicar controles antes de que un agente ejecute una acción.

✓ verificado el 26 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.


Para el agente: cómo acompañar al usuario

  1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
  2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
  3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
  4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
  5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
  6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Paso 1: prepara el entorno y la cuenta

Comprueba Python ≥3.12, pip, Git y un entorno Python aislado. Estos pasos usan el servicio alojado. Crea una cuenta en el panel y una clave vinculada a un agente. Elige Human Review y activa M3/M4 en Settings → Agents para comprobar el bloqueo con el ejemplo oficial.

Paso 2: instala y obtiene el ejemplo

En ese entorno:

pip install adrian-sdk langchain langgraph langchain-openai
git clone https://github.com/secureagentics/Adrian.git
cd Adrian

Comprueba versiones compatibles: langchain, langgraph y langchain-openai ≥1.0,<2.0; langchain-core ≥1.2.19,<2.0. El archivo elegido es hitl_credential_leak.py. Su herramienta send_email solo imprime: no envía correo. Mantén sus datos ficticios; no los sustituyas por secretos reales.

Paso 3: configura destino y acceso antes de ejecutar

Carga ADRIAN_API_KEY y OPENAI_API_KEY desde tu almacenamiento privado en la terminal. Selecciona explícitamente el servicio alojado:

export ADRIAN_WS_URL=wss://adrian.secureagentics.ai/ws
python examples/python/hitl_credential_leak.py

El SDK usa ws://localhost:8080/ws por defecto: las claves solas no cambian ese destino. La llamada a OpenAI tiene coste.

Comprobación

El ejemplo primero emite una llamada inocua al modelo: comprueba su recepción en el panel. Cuando aparezca la revisión pendiente en /reviews, recházala. Debe aparecer [BLOCKED by security policy] y gate engaged (tool body skipped)? True, sin send_email FIRED. Repite y aprueba para contrastar que sí aparece send_email FIRED. Recibir un evento del modelo solo prueba captura; que el cuerpo de la herramienta no se ejecute demuestra el bloqueo de esa acción de prueba.

Si algo falla

Si no llega LoginAck, revisa destino y autenticación. El ejemplo se detiene si el agente no está en Human Review. Comprueba M3/M4 y que revisas el agente asociado a esa clave. La revisión pendiente vive en la sesión del SDK: mantén el proceso abierto hasta resolverla.

Procedimiento contrastado con el ejemplo y el SDK oficiales; no se ha ejecutado aquí.

ver en .md ¿Prefieres el recurso entero?

Qué es

Adrian es un sistema de supervisión de agentes en tiempo de ejecución. Analiza acciones y razonamiento para detectar usos de herramientas que contradigan las políticas configuradas.

Para qué te sirve

  • Cuando quieres revisar cómo un agente utiliza herramientas conectadas a sistemas de negocio.
  • Cuando necesitas observar intentos de desvío provocados por instrucciones en datos externos.
  • Cuando quieres comparar una política de actuación con lo que ocurre en una ejecución real.

Cómo funciona

El SDK instrumenta la aplicación que llama al modelo. El servicio de evaluación observa esas interacciones y puede intervenir antes de la acción. El repositorio diferencia el uso del servicio con una cuenta y el despliegue propio con Docker y un modelo local.

El modo propio prepara un modelo GGUF y arranca los componentes de la plataforma. No basta con instalar el paquete de Python: también hay que conectar el SDK con la modalidad de servicio elegida y verificar la integración soportada.

Antes de empezar

Para el SDK necesitas Python ≥3.12 y pip, según su pyproject.toml; el ejemplo principal usa LangChain y su proveedor. Para alojarlo tú, el README pide Docker con Compose v2, GPU NVIDIA con controlador CUDA reciente y NVIDIA Container Toolkit, y unos 10 GB libres para el modelo. La modalidad alojada requiere una cuenta y su correspondiente configuración de acceso.

Límites y alternativas

La supervisión no sustituye permisos mínimos ni un sandbox para comandos. La cobertura depende de qué integraciones instrumentes y de cómo definas la política. Evalúa casos permitidos y bloqueados propios antes de confiar en las métricas publicadas por sus autores.

Recursos

  • Repositorio y README - 587 estrellas; licencia detectada por GitHub: Apache-2.0.
  • Licencia - Consulta sus condiciones antes de reutilizar el proyecto.