Saltearse al contenido

Simple Agent

Simple Agent es un agente de IA que responde mensajes y usa las herramientas que le conectes cuando las necesita. Funciona igual que Agent, pero sin el interruptor de funciones avanzadas: tiene lo esencial para un asistente y es más fácil de configurar.

Úsalo cuando quieras un asistente o una tarea automática con inteligencia artificial y no necesites límites de uso ni el resto de funciones avanzadas de Agent. Aun así, puede usar modelos de reserva activando Use Fallback Models y detenerse a esperar una aprobación con la herramienta Request Approval.

Cuándo usarlo

  • Un asistente de preguntas frecuentes en la web de tu empresa.
  • Redactar respuestas a correos de clientes a partir de su mensaje.
  • Consultar una herramienta (calendario, CRM, buscador) y resumir el resultado.
  • Procesar una lista de textos uno a uno, por ejemplo para clasificar reseñas.

Configuración

ConexiónQué conectar
Model (obligatorio)Un componente de modelo de IA, por ejemplo OpenAI.
ToolsLas herramientas que el agente puede usar. Puedes conectar varias.
Fallback ModelsAparece al activar Use Fallback Models en las opciones avanzadas. Uno o varios modelos de reserva. Si el modelo principal falla (el proveedor no responde, se supera un límite de uso, tarda demasiado o devuelve un error), el agente repite ese paso con el primero y, si también falla, con el siguiente, por orden. La conversación y lo que ya hicieron las herramientas se conservan. Conviene usar un modelo de otro proveedor.
CampoQué hace
Agent NameNombre del agente cuando otro agente lo usa como herramienta o subagente. Por defecto: Agent.
Agent DescriptionQué hace el agente. Otro agente la lee para decidir cuándo recurrir a él.
User PromptLa plantilla del mensaje que recibe el agente. Por defecto: {input}. Cada variable entre llaves se convierte en un campo con ese nombre, que puedes rellenar o conectar.
InputEl mensaje que procesa el agente, normalmente desde Chat Input. Es el campo de la variable {input}.
System PromptLas instrucciones de comportamiento del agente. Puedes escribirlas o conectar un componente Prompt. Por defecto: You are a helpful AI assistant.

Opciones avanzadas

CampoQué hace
Recursion LimitNúmero máximo de pasos internos en una respuesta. Si se alcanza, el agente se detiene. Por defecto: 1000.
StreamLa respuesta aparece en el chat a medida que se genera. Al activarlo aparece Stream Thinking, que muestra también el razonamiento del modelo.
Include State in responseAñade a la respuesta los datos internos de la ejecución del agente.
Use memoryEl agente recuerda la conversación. Al activarlo aparecen la conexión Memory y, en la pestaña Context and Memory, Memory Strategy: Trim (por defecto; el modelo solo recibe los últimos mensajes indicados en Memory Limit, -1 para todos), Delete Oldest (borra los mensajes más antiguos) o Summarize (resume los mensajes antiguos cuando la conversación supera Max Tokens y conserva los indicados en Messages to Keep).

En Memory puedes conectar un componente como Postgres Memory o Redis Memory para guardar la conversación en tu propio servicio. Si no conectas nada, NappAI la guarda por ti.

Guardrails

En la pestaña Avanzado, Guardrails pone reglas que el agente no se salta nunca: se revisa cada petición y cada acción antes de usar una herramienta. Consulta Guardrails, con un vídeo de ejemplo.

Uso como herramienta de un agente

Puedes conectar este componente a la entrada Tools de un agente. En la pestaña Tool, Tool Name y Tool Description son el nombre y la explicación con los que el agente reconoce la herramienta y decide cuándo usarla: escribe una descripción clara de lo que hace.

Procesamiento por lotes

Con el interruptor Batch Mode activado, el componente se ejecuta una vez por cada elemento de la lista que conectes en Batch Input y devuelve todos los resultados juntos en una lista. Parallel Executions indica cuántos elementos se procesan a la vez (de 1 a 5). Skip if Empty Batch Input salta el componente si la lista llega vacía, y Skip Branch if Empty Output detiene los componentes siguientes si el resultado está vacío. Más información en Conceptos clave.

Resultado

  • Response: la respuesta del agente como mensaje. Conéctala a Chat Output o a cualquier componente que reciba texto.
  • Agent: el agente configurado, para conectarlo a otro agente que delegue en él (por ejemplo, en Worker Agents de Supervisor Agent).
  • Tool: el agente convertido en herramienta, para la entrada Tools de otro agente.

Ejemplo

La academia de idiomas Lingua Norte quiere responder dudas sobre horarios y matrículas en su web. Conecta Chat Input a Input, un modelo de IA a Model y escribe en System Prompt: “Eres el asistente de Lingua Norte. Respondes sobre horarios, niveles y precios de matrícula. Si no sabes algo, ofrece el teléfono de secretaría.” Activa Use memory para que el asistente recuerde lo que el alumno ya ha preguntado y conecta Response a Chat Output.

Componentes relacionados

  • Agent: el agente principal, con funciones avanzadas de supervisión, costes y fiabilidad.
  • Deep Agent: para tareas largas y complejas.
  • Request Approval: herramienta para que el agente se detenga a esperar una aprobación.
  • Prompt y Chat Output.