Con el desarrollo del panorama de los agentes de IA, algunas empresas informan de sus dudas con respecto a la adopción generalizada de estos agentes autónomos.1 Algunos desafíos incluyen el gobierno, la ética, la colaboración entre humanos y la IA, la implementación y la escalabilidad. Sin embargo, crear agentes de IA fiables no tiene por qué ser complejo. Con IBM® watsonx Orchestrate, estas preocupaciones pueden mitigarse desde un único lugar. En este tutorial, aprenderá a usar Langflow y watsonx Orchestrate para crear agentes fiables y escalables listos para empresas.
Langflow es un marco de código abierto basado en Python para la creación de agentes de IA y otras aplicaciones de inteligencia IA. Langflow se construyó originalmente sobre LangChain, su marco. LangGraph, otra plataforma perteneciente a la misma familia, también se utiliza para construir sistemas agénticos mediante arquitecturas basadas en grafos. Lo que distingue a Langflow es su interfaz fácil de usar, de arrastrar y soltar, en la que los usuarios pueden conectar componentes de agentes para diseñar flujos de trabajo personalizados o comenzar con las plantillas prediseñadas. Como alternativa a este enfoque low-code o no-code, los desarrolladores pueden crear componentes personalizados e integrar flujos de agentes paso a paso en el código de la aplicación existente mediante la API de Langflow. En este tutorial de Langflow, exploraremos cómo crear e implementar agentes mediante:
Ambos enfoques corresponden a una sección de este tutorial. Tenga en cuenta que también puede acceder a este tutorial en GitHub.
¡Empecemos!
Este tutorial requiere:
Tenga en cuenta que sin estos requisitos, este tutorial no será reproducible.
En su terminal, ejecute el siguiente comando. Se le dará la instrucción de iniciar sesión en su cuenta de IBM Cloud utilizando su IBMid. Si tiene varias cuentas, deberá seleccionar una.
Nota: ¿Credenciales rechazadas? Es posible que sea un usuario federado. Vuelva a iniciar sesión con el
Sabrá que su inicio de sesión se ha realizado correctamente al ver un output similar.
Resultado:
Nota: Si nota que la región no es correcta, ejecute
Para ver sus recursos en la nube, ejecute
Resultado:
A continuación, apunte al recurso específico, ejecutando
Este resultado debería ser similar en output.
Resultado:
Con IBM Cloud Code Engine, puede ejecutar casi cualquier carga de trabajo contenedorizada sin gestionar servidores o infraestructura. La plataforma soporta desde microservicios y aplicaciones web hasta trabajos por lotes y funciones orientadas a eventos. También ofrece la creación de imágenes integrada a partir de su código fuente. Como todas las cargas de trabajo comparten el mismo entorno Kubernetes, se integran de forma natural. Code Engine está diseñado para mantener la infraestructura fuera de su camino y que pueda centrarse en crear aplicaciones. Instalar la CLI de Code Engine es nuestro próximo paso. Ejecute el siguiente comando en su terminal.
Resultado:
¡Genial! Ahora, vamos a seleccionar un proyecto dentro de Code Engine. Primero, muestre la lista de proyectos ejecutando
Resultado:
Un proyecto de Code Engine agrupa entidades como aplicaciones, trabajos y compilaciones. Sirve como unidad para gestionar los recursos y gobernar el acceso a esas entidades. Si no tiene ningún proyecto activo en Code Engine, ejecute
Para dirigirse al proyecto específico, ejecute
Resultado:
Nota: Si se produce un error aquí, asegúrese de haber seleccionado el entorno correcto con
Para utilizar Langflow mientras se utiliza la CLI de Code Engine, ejecute el siguiente comando.
Este comando puede ejecutarse durante varios minutos. No interfiera y deje que funcione.
Resultado:
A medida que se ejecuta el comando Langflow set up, podemos añadir un entorno para interactuar con nuestra máquina local y nuestra solución alojada SaaS.
En una nueva ventana de terminal, active un entorno virtual en el directorio que haya elegido. Puede cambiar
Active el entorno virtual con el siguiente comando y sustituya
MacOS/Linux:
Windows:
Ahora, en su navegador preferido, acceda a su lista de recursos de IBM Cloud, amplíe el desplegable de IA/Machine Learning y seleccione el recurso activo wxO. Su nombre debería parecerse a "Watson Orchestrate-itz", por ejemplo. A continuación, copie la URL que aparece en la ventana Credenciales. Mantenga esta página abierta en su navegador, ya que la necesitará en breve. En el siguiente comando, reemplace
Resultado:
Cuando se solicite la clave de la API de wxO, vuelva a la página de recursos que está abierta en su navegador. No realice la entrada de la clave de API que se encuentra encima de la URL que ha copiado. En su lugar, haga clic en el botón Lanzar Watsonx Orchestrate. Luego, haga clic en el icono circular con sus iniciales en la esquina superior derecha de la pantalla y abra la Configuración. Seleccione la pestaña de detalles de la API y haga clic en el botón Generar clave de API. A continuación, introduzca cualquier nombre y descripción para su clave API y seleccione "Desactivar la clave filtrada" en la sección "Acción filtrada". Lo más importante es seleccionar "Sí" en la sección "Gestión de sesiones" para habilitar la gestión de sesiones para los inicios de sesión de la CLI y hacer clic en "Crear". Su clave API debería aparecer. Copie y pegue la clave en el terminal que estaba utilizando hace unos momentos para satisfacer la solicitud de introducir la clave API de wxO.
Resultado:
¡Genial! Langflow ya está activo.
Para establecer un entorno estable de Code Engine que no elimine nuestra aplicación Langflow tras un tiempo de espera fijo, abra su navegador de nuevo. Acceda a su resumen de contenedores IBM Cloud. Debería ver aparecer su proyecto de Code Engine tal y como se ha creado recientemente. Abra el proyecto. A continuación, abra su aplicación de Langflow. En la pestaña Configuración, abra el componente Recursos y escalado. El único cambio que necesitamos hacer aquí es aumentar el número mínimo de instancias de 0 a 1. Por último, haga clic en el botón Implementar para aplicar esta revisión de configuración.
Una vez completado este paso, haga clic en el botón de Probar la aplicación y luego en el hipervínculo URL de la Aplicación. Esta acción abrirá nuestra instancia IBM Cloud de Langflow.
Hay muchas formas de construir un flujo de Langflow. Puede usar plantillas prediseñadas o crear la suya propia desde cero. En este tutorial, exploraremos esto último. Para empezar, haga clic en + Blank Flow. Este ejemplo demuestra un flujo que puede crear, pero no dude en explorar la gran cantidad de componentes e integraciones integrados en Langflow.
Entrada de chat - Recibe la entrada del usuario del chat.
Output del chat: devuelve el output del flujo al usuario del chat.
Agente: utiliza una Integración de modelos de lenguaje de gran tamaño (LLM) para responder a la entrada del usuario y puede conectarse a varias herramientas.2
MCP Tools: se conecta a un servidor de Model Context Protocol (MCP) y expone las funciones del servidor MCP como herramientas que los agentes pueden utilizar para responder a la entrada.2
IBM watsonx.ai - Proporciona acceso a los modelos para generación de texto de IBM watsonx.ai. 3
Búsqueda de noticias: extrae el contenido de Google News y produce un marco de datos estructurado que contiene el título, el enlace, la fecha de publicación y el resumen de cada artículo.4
arXiv - Busca artículos relevantes en arXiv.org y muestra los resultados en formato DataFrame. 5
Por último, seleccione + Nuevo componente personalizado en la parte inferior del menú.
Para facilitar la visualización, organice su flujo de la siguiente manera.
2. Conecte el componente de Entrada de chat al campo "Entrada" del componente Agente.
3. Conecte el componente Output de chat al campo "Respuesta" del componente Agente.
4. En el componente Agente, configure el “Proveedor de modelo” en “Personalizado” en el menú desplegable. Dependiendo de la versión de Langflow que esté utilizando, es posible que vea "Conectar otros modelos" en su lugar. Cualquiera de las dos opciones es aceptable.
5. En el componente IBM watsonx.ai, seleccione el endpoint de API de watsonx.ai adecuado para sus credenciales de API. A continuación, pegue el ID del proyecto watsonx.ai y la clave API en los campos correspondientes. A continuación, seleccione el nombre del modelo de lenguaje de gran tamaño que prefiera. En este tutorial, podemos seleccionar
6. Habilite el modo Herramientas usando el interruptor para arXiv, Búsqueda de noticias y Componente personalizado. Verá que este conmutador aparece en el menú del encabezado haciendo clic en cualquier lugar de cada uno de estos componentes. Con este modo activado, ahora puede conectar estos componentes al campo "Herramientas" del componente Agente . Los componentes arXiv y News Search están configurados y listos para usarse. Ahora podemos centrarnos en configurar los demás componentes.
7. En el menú de cabecera del Componente Personalizado, seleccione <> Código. Aquí, podemos personalizar el comportamiento del componente editando el código Python que lo define.6 Como ejemplo sencillo, podemos crear una herramienta que devuelva la fecha de hoy, conocimiento que de otro modo sería inaccesible a un LLM. Reemplace el código estándar con el siguiente:
Adelante, guarde sius cambios. Ahora debería ver el componente con su nuevo nombre, descripción e icono.
8. El número de herramientas que proporcione a su agente depende de usted. Sin embargo, recuerde no abrumar a su agente con demasiadas herramientas, ya que podría obstaculizar el rendimiento y la precisión. La última herramienta que habilitaremos es un servidor MCP. Puede conectarse a cualquier servidor que elija. En este tutorial, podemos conectarnos al servidor MCP de Alpha Vantage.7 El servidor oficial Alpha Vantage MCP facilita a los LLM y a los agentes la extracción de datos bursátiles pasados y en tiempo real mediante el protocolo de contexto del modelo. Para conectarse a este servidor, abra el menú desplegable "Servidor MCP" en el componente Herramientas MCP y haga clic en + Agregar servidor MCP. En la pestaña STDIO, proporcione cualquier nombre para su servidor, por ejemplo, “av_mcp”, y pegue el siguiente comando:
¡Buen trabajo! Su flujo está completo y debería parecerse a la siguiente captura de pantalla.
Para comprobar que la línea de investigación funciona como se espera, abra el Playground y hable con su agente recién creado. Haga al agente preguntas que requieran una invocación de una de las herramientas conectadas. Algunos ejemplos de valores de entrada incluyen:
Debería ver cómo el agente invoca sus herramientas disponibles y produce el output correcto. Si experimenta algún problema en esta fase, vuelva a su flujo y asegúrese de que sus credenciales son correctas y de que ha seguido cada uno de los pasos.
Una forma de conectar este flujo a watsonx Orchestrate es como un servidor MCP. Haga clic en el menú desplegable Compartir de la esquina superior derecha y seleccione "Servidor MCP". Haga clic en la pestaña "JSON". Debería ver un código similar a este ejemplo:
Copie la URL en su fragmento JSON. Tenga en cuenta que será diferente del ejemplo anterior. Regrese a su terminal y pegue la URL de su servidor MCP en lugar del marcador de posición
Resultado:
En su navegador, entre en watsonx Orchestrate y cree un nuevo agente desde cero. Introduzca cualquier nombre y descripción para su agente. Una vez creado, abra la pestaña Conjunto de herramientas y haga clic en el botón Añadir herramienta. Desde allí, seleccione importar herramientas desde un servidor MCP. Desde el desplegable Select MCP server, seleccione el servidor que importamos, active las herramientas desactivando la activación y cierre la ventana. A continuación, haga clic en Implementar. Una vez implementado, puede chatear con su agente en la ventana de Vista previa o en la interfaz de chat que se encuentra en el menú de la página plegada.
¡Hagamos una consulta a nuestro agente! Por ejemplo, "Encuentra 5 artículos de investigación sobre computación cuántica".
¡Genial! El chatbot agéntico se comporta como se esperaba, no solo genera la respuesta correcta, sino que también invoca la herramienta arXiv correcta. No dude en experimentar con diferentes instrucciones.
Con este enfoque, no se requiere Code Engine. Este enfoque configura un entorno de desarrollo local mediante el SDK de watsonx Orchestrate Developer Edition, una versión ligera de watsonx Orchestrate que funciona como un servidor de desarrollo local.
Antes de empezar a construir localmente con Langflow, instale la Developer Edition del ADK de wxO. Tenga en cuenta que esta Developer Edition no era necesaria para el primer enfoque de este tutorial.
En su IDE preferido, configure su entorno. Cree una carpeta llamada
wxo-langflow-agent/ ├── .env ├── tools/ └── agents/
2. Abra el terminal y active un entorno virtual. Puede cambiar
Active el entorno virtual con el siguiente comando y sustituya
MacOS/Linux:
Windows:
3. En el archivo .env, defina las siguientes variables de entorno. Para obtener más información, consulte la guía de configuración.
4. Ejecute el siguiente comando para instalar el servidor watsonx Orchestrate Developer Edition. No necesitamos instalar Langflow porque está incluido en la ADK Developer Edition. El indicador de comando
Este comando puede durar varios minutos si es la primera vez que activa un servidor.
Solución de problemas: si instaló watsonx Orchestrate Developer Edition antes de la versión 2.0 de ADK en el pasado y experimenta errores al iniciar contenedores, ejecute:
El final de su output debería parecerse al siguiente ejemplo.
Resultado:
El ADK de watsonx Orchestrate define los entornos como las instancias de watsonx Orchestrate a las que puede conectarse. Su entorno será una instancia de Developer Edition que se ejecutará en su ordenador portátil. Puede usar el comando orchestrate env listlocallocal
orchestrate env activate local
Resultado:
[INFO] - local tenant found
[INFO] - Environment 'local' is now active
A continuación, ejecute este comando para iniciar la IU de chat en su navegador predeterminado.
orchestrate chat start
Resultado:
[INFO] - Chat UI Service started successfully.
[INFO] - Waiting for UI component to be initialized...
[INFO] - Opening chat interface at http://localhost:3000/chat-lite
El editor Langflow está disponible a través de watsonx Orchestrate Developer Edition en el puerto 7861, como se puede ver en el output anterior.
Podemos explorar dos opciones para importar flujos de Langflow a nuestro servidor local de watsonx Orchestrate:
a) Importar el flujo como un servidor MCP local.
b) Importar el flujo como JSON.
Este paso se parece al paso 7 de la primera mitad de este tutorial, con algunos pequeños cambios.
Haga clic en el desplegable Compartir en la esquina superior derecha de su Langflow y seleccione "MCP Server". Haga clic en la pestaña "JSON". Debería ver un código similar al siguiente ejemplo:
{
"mcpServers": {
"lf-starter_project": {
"command": "uvx",
"args": [
"mcp-proxy",
"http://localhost:7861/api/v1/mcp/project/41c9434f-67bf-439e-8dac-b7bb09b1d1ca/sse"
]
}
}
}
Copie la URL en su fragmento JSON. Tenga en cuenta que será diferente del ejemplo anterior. Vuelva a su terminal y pegue el siguiente comando utilizando su URL en lugar del siguiente ejemplo. A diferencia del comando que ejecutábamos al usar IBM Cloud, aquí debe reemplazar localhosthost.docker.internal
orchestrate toolkits add \
--kind mcp \
--name langflow_research_mcp \
--description "LangFlow MCP Server" \
--command "uvx mcp-proxy http://host.docker.internal:7861/api/v1/mcp/project/41c9434f-67bf-439e-8dac-b7bb09b1d1ca/sse" \
--tools "*"
Resultado:
[INFO] - Successfully imported tool kit langflow_research_mcp
En la instancia local de watsonx Orchestrate que se ejecuta en su navegador, haga clic en "Crear nuevo agente" e introduzca un nombre y una descripción para su nuevo agente. A continuación, haga clic en el botón Crear .
4. En la pestaña Toolset, haga clic en el botón Añadir herramienta. Seleccione "instancia local" para añadir nuestro servidor MCP ya importado, marque la casilla correspondiente al servidor MCP importado y haga clic en Añadir al agente.
5. ¡Empiece a chatear!
Como alternativa a la importación de flujos como servidores MCP, podemos utilizar el ADK para importar flujos como archivos JSON exportados.
1. Este enfoque funciona mejor para flujos simples. A modo de demostración, utilicemos este flujo:
Exporte el flujo a JSON haciendo clic en el botón Compartir y seleccionando Exportar. Introduzca el nombre y la descripción de la herramienta o el flujo que desee. El nombre de la herramienta solo debe contener caracteres alfanuméricos y guiones bajos, y no debe empezar por un número ni por un guión bajo.
2. Añada el archivo JSON recién exportado a la carpeta
3. Ejecute el siguiente comando para importar su flujo a watsonx Orchestrate.
4. Después de importar el flujo de Langflow como herramienta, el próximo paso es conectarlo a un sistema de agentes. Puede realizar este paso creando un nuevo agente en la IU de watsonx Orchestrate o copiando la siguiente definición de agente a un nuevo archivo
Ahora, importe el agente simple ejecutando:
5. Actualice el navegador de la IU de watsonx Orchestrate que se ejecuta localmente para ver reflejados los cambios. En el menú desplegable Agentes, seleccione "Agente de ArXiv" y formule preguntas que requieran el uso de la herramienta arXiv.
Ejemplo de instrucción: “Búscame 5 artículos de investigación sobre computación cuántica”.
Resultado:
¡Genial! El agente determinó que era necesario invocar la herramienta
Este tutorial le ha proporcionado las habilidades esenciales para aprovechar Langflow y watsonx Orchestrate para construir agentes robustos, escalables y listos para la empresa. Ha aprendido a importar flujos LangFlow agénticos como servidores MCP utilizando watsonx Orchestrate como software como servicio (SaaS) junto con IBM Cloud. Además, ya sabe cómo importar flujos básicos de LangFlow usando localmente el IBM Watsonx Orchestrate Agent Development Kit (ADK). Siguiendo las instrucciones paso a paso, ha aprendido a diseñar, desarrollar e implementar agentes que invocan herramientas personalizadas y prediseñadas para resolver las consultas de los usuarios. Con la interfaz visual intuitiva de Langflow, ha creado intrincados flujos de trabajo y watsonx Orchestrate le ha permitido gestionar y escalar estos agentes de manera eficiente. Como próximo paso, aplique los conocimientos adquiridos en este tutorial trabajando en un caso de uso del mundo real. Elija un problema o proceso empresarial específico dentro de su organización que podría beneficiarse de la automatización y diseñe una solución basada en Langflow y watsonx Orchestrate para abordarlo. Esta experiencia práctica consolidará su comprensión y le ayudará a identificar áreas de mejora o exploración adicional.
Si tiene problemas o preguntas, consulte la documentación. Los problemas más comunes se tratan en la guía de solución de problemas. También puede revisar los problemas de GitHub para ver si otros han experimentado problemas similares.
Ponga la IA a trabajar en su negocio con la experiencia líder en IA del sector de IBM y junto a su cartera de soluciones.
Reinvente las operaciones y flujos de trabajo críticos añadiendo IA para maximizar las experiencias, la toma de decisiones en tiempo real y el valor empresarial.
1 Satyadhar Joshi. “Review of Autonomous Systems and Collaborative AI Agent Frameworks.” International Journal of Science and Research Archive. Vol. 14, núm. 2. 28 de febrero de 2025, págs. 961–972. https://ijsra.net/content/review-autonomous-systems-and-collaborative-ai-agent-frameworks.
2 “Agents | Langflow Documentation.” Langflow.org. 2025. docs.langflow.org/components-agents.
3 “IBM | Langflow Documentation.” Langflow.org. 2025. docs.langflow.org/bundles-ibm.
4 “Data | Langflow Documentation.” Langflow.org. 2025. docs.langflow.org/components-data.
5 “ArXiv | Langflow Documentation.” Langflow.org. 2025. docs.langflow.org/bundles-arxiv.
6 “Components Overview | Langflow Documentation.” Langflow.org. 2025. docs.langflow.org/concepts-components.
7 “Alpha Vantage MCP for Stock Market Data.” Alphavantage.co. 2025. mcp.alphavantage.co/.