Las piezas del Deep Agent
El Deep Agent trae de serie lo que necesita un trabajo largo y deja el resto como piezas que activas en sus opciones avanzadas. La regla es sencilla: activa solo lo que el encargo necesita. Cada pieza de más es información que el modelo lee en cada paso, y eso cuesta tiempo y dinero.
Lo que viene incluido
- Plan de trabajo. Ante un encargo con varias partes, el agente escribe una lista de tareas y la va actualizando a medida que avanza. Así no se pierde en trabajos largos ni se salta pasos.
- Archivos de trabajo. El agente tiene un espacio propio donde guarda notas, borradores y resultados intermedios mientras trabaja, en lugar de llevarlo todo en la conversación. Ahí es también donde lee sus skills.
- Líneas de estado. Con Tool Status activado (por defecto), el chat muestra qué herramienta está usando en cada momento. En el Entorno de Pruebas, la lista de Ejecuciones enseña cada paso con lo que entró y lo que salió.
Herramientas
Todo componente con salida Tool se conecta a la entrada Tools: buscadores web, hojas de cálculo, correo, bases de datos, tu almacenamiento, un Python Code con tu propia lógica o incluso otro agente. Algunas ideas para que el agente las use bien:
- Conecta solo las herramientas del trabajo. Con veinte herramientas disponibles el agente tarda más en decidir y se equivoca más que con cuatro.
- En la pestaña Tool de cada componente, Tool Description es lo que el agente lee para decidir cuándo usarla. Escríbela pensando en él: qué hace y cuándo conviene.
- Los datos que debe decidir el agente se marcan con el botón de la IA junto al campo («Definido por IA»). Los que no marques se quedan con el valor que escribas.
Servidores MCP
MCP es un estándar abierto con el que muchas aplicaciones ofrecen sus herramientas a cualquier agente. En la paleta, la categoría MCPs reúne más de cien servidores preparados; también puedes conectar cualquier otro con MCP Connection. Se conectan a Tools igual que una herramienta normal: eliges la herramienta del servidor y marcas los datos que rellena la IA. Ver Usar servidores MCP.
Skills
Una skill es una guía de trabajo que el agente consulta cuando la tarea coincide con su descripción: los pasos de un procedimiento, las reglas de tu empresa o el formato de un informe. Se activa con Enable Skills, que muestra la conexión Skills. Puedes conectar tus propias skills con Stored Skill o skills ya preparadas por NappAI, de la familia Skills de la paleta, para servicios como Slack, HubSpot, Jira o Google Workspace (ManagedSkill).
Al activar Enable Skills se activa también Use memory, para que el agente recuerde lo que ya ha leído. Cómo escribir una buena skill: Skills.
Subagentes
Con Enable Subagents aparece la conexión Subagents, donde conectas la salida Agent de otros agentes. El Deep Agent les encarga partes del trabajo y cada uno trabaja con su propia conversación, sin llenar la del principal. Úsalos cuando el trabajo tenga partes muy distintas (investigar, redactar, revisar) o cuando una parte genere mucha información que el agente principal no necesita ver entera. Dale a cada subagente un Agent Name y una Agent Description claros: es lo que el agente principal lee para elegir.
Entorno de código
Con Enable Sandbox aparece la conexión Sandbox, donde conectas un ordenador aislado, como Nappai Sandbox. El agente puede ejecutar código en él para procesar datos, hacer cálculos o generar archivos y gráficos, sin tocar nada de tu sistema. Las skills conectadas se copian también a ese entorno.
Revisión antes de entregar
Con Enable Rubric, antes de terminar un revisor comprueba el trabajo con tus criterios (uno por línea) y, si falta algo, el agente sigue trabajando. Es la forma de exigir un resultado concreto, por ejemplo «el informe cita al menos tres fuentes».
Reglas que no se saltan
Guardrails revisa cada petición y cada acción antes de ejecutar una herramienta, y bloquea las que rompen tus reglas. Es importante en un harness con herramientas que cambian cosas (enviar, borrar, pagar). Ver Guardrails.
Qué pieza usar en cada caso
| Si necesitas que el agente… | Usa |
|---|---|
| Haga cosas en otros servicios | Herramientas o servidores MCP |
| Trabaje con el método de tu empresa | Skills |
| Divida un trabajo muy grande en partes | Subagentes |
| Calcule, transforme datos o genere archivos | Entorno de código |
| Entregue solo cuando el trabajo cumple unos mínimos | Revisión (Rubric) |
| No haga nunca ciertas cosas | Guardrails |
| Recuerde la conversación | Use memory |