BasicLangchainV1.0 Agent

Este componente, llamado BasicLangchainV1.0 Agent, actúa como un asistente inteligente dentro de tu sistema de automatización Nappai. Es la base para crear chatbots o asistentes que no solo responden con información pregrabada, sino que pueden “pensar” y utilizar herramientas externas para obtener respuestas precisas y actualizadas.

Imagina este componente como una secretaria virtual avanzada: cuando le haces una pregunta, puede responderla directamente o, si necesita datos específicos (como el clima, el estado de una base de datos, o información de una página web), puede buscar esa información en tiempo real y luego resumirla para ti.

¿Cómo funciona?

Internamente, este componente utiliza una tecnología poderosa conocida como Langchain. Piensa en ella como una estructura que conecta un modelo de lenguaje (la “inteligencia” del agente) con diversas herramientas.

Análisis de tu pregunta: Cuando envías un mensaje, el agente analiza lo que has escrito para entender tu intención.
Decisión inteligente: El agente decide si puede responder con su propio conocimiento o si necesita ayuda externa.
Uso de herramientas: Si la respuesta requiere datos en tiempo real o acciones específicas (por ejemplo, “busca el último correo”), el agente activa las herramientas que hayas configurado previamente.
Respuesta final: Una vez que tiene la información necesaria (ya sea interna o de las herramientas), genera una respuesta clara y coherente para ti.

Conexión y Credenciales

Este componente es una entidad lógica de software y no requiere conectarse directamente a cuentas externas (como Gmail o Salesforce) mediante credenciales de acceso dentro de su propia configuración.

Sin embargo, para que funcione correctamente:

Asegúrate de tener Herramientas (Tools) configuradas en tu flujo de trabajo y vinculadas al agente.
El agente dependerá de las herramientas que le asignes para acceder a datos externos.

Operaciones

Esta sección no aplica para el BasicLangchainV1.0 Agent en su configuración actual, ya que actúa como un nodo de proceso continuo (agente conversacional) en lugar de una operación única seleccionable. Su función principal es mantener la conversación activa y procesar entradas en tiempo real.

Entradas

Para que este agente sea útil, debes proporcionarle contexto y contexto de conversación. Aunque el código muestra principalmente su configuración, en la práctica necesitarás configurar las siguientes entradas desde la interfaz visual de Nappai:

Campos de Entrada

Los siguientes campos están disponibles para configurar el comportamiento de este agente:

Display Name: Este es el nombre visible que aparecerá en tu dashboard. Úsalo para identificar fácilmente el agente en tu lista de componentes.
Name: El identificador interno único del agente. Úsalo solo si necesitas referencia técnica avanzada o depuración.
Description: Una breve explicación de para qué sirve este agente en tu flujo. Ayuda a otros usuarios (o a ti mismo en el futuro) a entender su propósito rápidamente.
Tools (Herramientas): Campo crítico. Aquí es donde conectas las funciones externas que el agente puede usar. Sin herramientas, el agente solo podrá responder con su conocimiento base.
Chat History (Historial de Chat): Campo de contexto. Permite al agente recordar la conversación anterior para mantener el hilo del tema.

Salidas

El resultado principal de este componente es una cadena de texto (respuesta) generada por el agente.

Esta salida es la respuesta final que el agente ha preparado para ti después de analizar tu mensaje y, si fue necesario, consultar sus herramientas.

Ejemplo de Respuesta JSON

En un entorno de desarrollo o depuración, la salida podría estructurarse de la siguiente manera: json { “output”: “He analizado tu solicitud sobre las ventas del último trimestre. Los datos indican un crecimiento del 15% respecto al año anterior. ¿Deseas que exporte este informe a Excel?”, “usage”: { “tools_used”: true, “tool_names”: [“sales_db_query”], “final_model_response”: true } }

Nota: En la mayoría de los casos de uso en Nappai, solo verás el campo output como texto plano para conectar con otros nodos.

Conectividad

Este agente es el “cerebro” de una conversación, por lo que su conectividad es generalmente secuencial:

Entrada (Input): Se conecta comúnmente a un Trigger de Usuario (como un mensaje de chat en WhatsApp, Telegram o un formulario web) o a la salida de otro agente que requiera una confirmación adicional.
Salida (Output): Se conecta normalmente a un Nodo de Respuesta (para enviar el texto al usuario) o a otro Agente si la respuesta requiere un procesamiento más complejo o una decisión binaria (sí/no).

Tiene sentido lógico conectar este agente justo después de recibir una consulta del usuario y antes de enviar la respuesta final, actuando como el intermediario que “piensa” y busca la información.

Ejemplo de Uso

Escenario: Automatización de soporte técnico básico.

Entrada: Un usuario envía el mensaje: “¿Cuál es el estado de mi pedido #12345?”
Componente (BasicLangchainV1.0 Agent):
- Recibe el mensaje.
- Reconoce que necesita datos de un sistema externo (la base de datos de pedidos).
- Utiliza la herramienta “Buscar Pedido” conectada a su perfil.
- Obtiene el resultado: “En tránsito”.
Salida: El agente genera el texto: “Tu pedido #12345 está en tránsito y llegará mañana.”
Conexión siguiente: Este texto se envía directamente al usuario a través del canal de chat.

Plantillas

No se han identificado plantillas predefinidas específicas para este componente en la configuración actual.

Componentes Relacionados

No se han identificado componentes relacionados específicos en la configuración actual.

Notas Importantes

No se han identificado notas críticas de seguridad, limitaciones o comportamiento específicos para este componente en la configuración actual.

Consejos y Mejores Prácticas

Define claramente las herramientas: La capacidad del agente para ayudar depende directamente de las herramientas que le asignes. Cuantas más herramientas precisas tengas vinculadas, más útil será el agente.
Usa descripciones claras: En el campo “Description”, escribe en lenguaje natural qué hace el agente. Esto ayuda al sistema a entender mejor cómo interpretar tu entrada.
Monitorea el modo de desarrollo: Ten en cuenta que este agente está etiquetado como “Development”. Esto significa que su comportamiento podría cambiar en futuras actualizaciones. Úsalo para probar flujos de conversación avanzados sin preocuparte por la estabilidad de producción inmediata.

Consideraciones de Seguridad

Como este componente puede interactuar con herramientas externas (bases de datos, APIs, etc.), asegúrate de que las herramientas conectadas tengan los permisos adecuados. No expongas herramientas que puedan modificar datos críticos sin una revisión previa del flujo de trabajo.