Con el escenario en desarrollo de los agentes de IA, algunas empresas reportan reticencias con respecto a la adopción generalizada de estos agentes autónomos.1 Algunos desafíos incluyen gobernanza, ética, colaboración humano-IA, despliegue y escalabilidad. Sin embargo, crear agentes de IA confiables no tiene por qué ser complejo. Con IBM watsonx Orchestrate, estas preocupaciones se pueden mitigar de forma integral en un solo lugar. En este tutorial, aprenderá a usar Langflow y watsonx Orchestrate para crear agentes confiables y escalables listos para la empresa.
Langflow es un marco de código abierto basado en Python para construir agentes de IA y otras aplicaciones de IA. Langflow se construyó originalmente sobre LangChain, su marco principal. LangGraph, otra plataforma dentro de la misma familia, también se utiliza para construir sistemas agénticos mediante el uso de arquitecturas basadas en gráficos. 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 de código bajo o sin código, 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, exploramos cómo crear y desplegar 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.
¡Comencemos!
Este tutorial requiere:
Tenga en cuenta que sin estos requisitos, este tutorial no será reproducible.
En su terminal, ejecute el siguiente comando. Recibirá una instrucción para iniciar sesión en su cuenta de IBM Cloud mediante 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 la marca
Sabrá que su inicio de sesión fue exitoso al ver resultados similares.
Resultado:
Nota: Si observa 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 la salida.
Resultado:
Con IBM® Cloud Code Engine, puede ejecutar prácticamente cualquier carga de trabajo en contenedores sin necesidad de gestionar servidores ni infraestructura. La plataforma admite desde microservicios y aplicaciones web hasta trabajos por lotes y funciones basadas en eventos. También ofrece la posibilidad de crear imágenes a partir del código fuente. Dado que todas las cargas de trabajo comparten el mismo entorno Kubernetes, se integran de forma natural. Code Engine está diseñado para que la infraestructura no estorbe y pueda concentrarse en crear aplicaciones. El siguiente paso es instalar la CLI de Code Engine. Ejecute el siguiente comando en su terminal.
Resultado:
¡Excelente! Ahora, apuntemos a 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 regular el acceso a esas entidades. Si no tiene ningún proyecto de Code Engine activo, ejecute
Para apuntar al proyecto específico, ejecute
Resultado:
Nota: Si experimenta un error aquí, seleccione el entorno correcto con
Para usar Langflow mientras usa Code Engine CLI, ejecute el siguiente comando.
Este comando puede ejecutarse durante varios minutos. No interfiera y permita que se ejecute.
Resultado:
A medida que se ejecuta el comando de configuración de Langflow, podemos agregar un entorno para interactuar con nuestra máquina local y solución alojada SaaS.
En una nueva ventana de terminal, active un entorno virtual en el directorio elegido. Puede cambiar
Active el entorno virtual con el siguiente comando y reemplace
MacOS/Linux:
Windows:
Ahora, en su navegador preferido, acceda a su lista de recursos de IBM Cloud, amplíe el menú desplegable de IA/Machine learning y seleccione el recurso activo wxO. Su nombre debe parecerse a “Watson Orchestrate-itz”, por ejemplo, y luego debe copiar la URL que se encuentra 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 le pida la clave de API de wxO, regrese a la página de Recursos que está abierta en su navegador. No ingrese la clave de API situada encima de la URL que copió. En su lugar, haga clic en el botón Iniciar watsonx Orchestrate. Luego, haga clic en el icono circular con sus iniciales en la esquina superior derecha de la pantalla y abra Configuración. Seleccione la pestaña Detalles de API y haga clic en el botón Generar clave de API. A continuación, ingrese cualquier nombre y descripción para su clave de API y seleccione “Deshabilitar la clave filtrada” en la sección “Acción filtrada”. Lo más importante es que seleccione “Sí” en la sección “Gestión de sesiones” para habilitar la gestión de sesiones para los inicios de sesión de CLI y haga clic en “Crear”. Debería aparecer su clave de API. Copie y pegue la clave en el terminal que estaba usando hace unos momentos para satisfacer la solicitud de ingresar la clave de API de wxO.
Resultado:
¡Excelente! Langflow ya está activo.
Para lograr un entorno estable en Code Engine que no elimine nuestra aplicación Langflow luego de un periodo de espera fijo, abra su navegador una vez más. Acceda a su visión general de contenedores de IBM Cloud. Debería ver su proyecto de Code Engine tal como fue creado recientemente. Abra el proyecto. A continuación, abra la aplicación Langflow. En la pestaña Configuración, abra el componente Recursos y escalado. El único cambio que debemos realizar aquí es aumentar el número mínimo de instancias de 0 a 1. Finalmente, haga clic en el botón Desplegar para aplicar esta revisión de configuración.
Una vez que haya completado este paso, haga clic en el botón Probar aplicación y en el hipervínculo URL de la aplicación. Esta acción abrirá nuestra instancia IBM Cloud de Langflow.
Hay muchas formas de crear un flujo de Langflow. Puede usar plantillas prediseñadas o crear la propia desde cero. En este tutorial, exploraremos esto último. Para comenzar, haga clic en + Flujo en blanco. Este ejemplo demuestra un flujo que puede crear, pero no dude en explorar la gran cantidad de componentes e integraciones en Langflow.
Entrada de chat: recibe la entrada del usuario del chat.
Salida del chat: devuelve la salida del flujo al usuario en el chat.
Agente: utiliza una integración de modelo de lenguaje grande (LLM) para responder a la entrada del usuario y se puede conectar a varias herramientas.2
Herramientas MCP: se conecta a un servidor del Model Context Protocol (MCP) y expone las funciones del servidor MCP como herramientas que los agentes pueden usar para responder a las entradas.2
IBM watsonx.ai - Proporciona acceso a los modelos IBM® watsonx.ai para generación de texto.3
Búsqueda de noticias: extrae contenido de Google News y genera un DataFrame estructurado que contiene el título, el enlace, la fecha de publicación y el resumen de cada artículo.4
arXiv: busca en ARXiv.org documentos relevantes y genera los resultados en un 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 Entrada de chat al campo “Entrada” del componente Agente.
3. Conecte el componente Salida de chat al campo “Respuesta” del componente Agente.
4. En el componente Agente, establezca 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. Luego, pegue el ID del proyecto watsonx.ai y la clave de API en los campos correspondientes. A continuación, seleccione el nombre del modelo de lenguaje grande que prefiera. En este tutorial, podemos seleccionar
6. Habilite el modo de herramientas utilizando el interruptor para arXiv, Búsqueda de noticias y Componente personalizado. Verá que esta opción aparece en el menú del encabezado al hacer clic en cualquier lugar de cada uno de estos componentes. Con este modo habilitado, ahora puede conectar estos componentes al campo “Herramientas” del componente Agente. Los componentes de arXiv y Búsqueda de noticias están configurados y listos para usarse. Ahora podemos centrarnos en configurar los otros componentes.
7. En el menú de encabezado 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 el conocimiento de hoy, que de otro modo sería inaccesible, a un LLM. Reemplace el código estándar con el siguiente:
Continúe y guarde sus cambios. Ahora debería ver el componente que refleja su nuevo nombre, descripción e icono.
8. La cantidad 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 extraer datos de existencias pasadas y en tiempo real mediante el MCP. Para conectarse a este servidor, abra el menú desplegable “Servidor MCP” en su 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 ser similar a la siguiente captura de pantalla.
Para verificar que el pipeline de investigación esté funcionando como se esperaba, abra el Playground y chatee con su agente recién creado. Haga preguntas al agente que requieran una invocación de una de las herramientas conectadas. Algunos ejemplos de valores de entrada incluyen:
Debería ver que el agente invoca sus herramientas disponibles y produce el resultado correcto. Si experimenta algún problema en esta etapa, vuelva a su flujo y verifique que sus credenciales sean correctas y de que siguió todos los pasos.
Una forma de conectar este flujo a watsonx Orchestrate es como un servidor MCP. Haga clic en el menú desplegable Compartir en 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 diferirá del ejemplo anterior. Vuelva a su terminal y pegue la URL del servidor MCP en lugar del marcador de posición
Resultado:
En su navegador, diríjase a watsonx Orchestrate y cree un nuevo agente desde cero. Ingrese 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 Agregar herramienta. Desde allí, seleccione Importar herramientas desde un servidor MCP. En el menú desplegable Seleccionar servidor MCP, seleccione el servidor que importamos, active las herramientas alternando la activación y cierre la ventana. A continuación, haga clic en Desplegar. Una vez desplegado, puede chatear con su agente en la ventana Vista previa del chat o en la interfaz de chat que se encuentra en el menú de la página contraída.
¡Hagamos una consulta a nuestro agente! Por ejemplo, “Encuentra 5 trabajos de investigación sobre computación cuántica”.
¡Excelente! El chatbot agéntico se comporta como se esperaba no solo al dar resultados correctos, sino también al invocar la herramienta arXiv correcta. Siéntase libre de experimentar con diferentes instrucciones.
Con este enfoque, no se requiere Code Engine. Este enfoque configura un entorno de desarrollo local mediante el uso de SDK watsonx Orchestrate Developer Edition SDK, una versión ligera de watsonx Orchestrate que funciona como un servidor de desarrollo local.
Antes de comenzar a construir localmente con Langflow, instale Developer Edition del wxO ADK. Tenga en cuenta que esta Developer Edition no era necesaria para el primer enfoque de este tutorial.
En su IDE preferido, configure su entorno. Crea una carpeta llamada
wxo-langflow-agent/ ├── .env ├── herramientas/ └── agentes/
2. Abra el terminal y active un entorno virtual. Puede cambiar
Active el entorno virtual con el siguiente comando y reemplace
MacOS/Linux:
Windows:
3. En el archivo.env, establezca 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 se incluye como parte de ADK Developer Edition. El indicador de comando
Este comando puede ejecutarse durante varios minutos si es la primera vez que activa un servidor.
Resolución de problemas: Si instaló watsonx Orchestrate Developer Edition antes de la versión 2.0 de ADK y experimentó errores al iniciar contenedores, ejecute:
El final de su salida debe parecerse al siguiente ejemplo.
Resultado:
watsonx Orchestrate ADK 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 computadora portátil. Puede usar el comando orchestrate env listlocallocal
orchestrate env activar local
Resultado:
[INFO] - local tenant found
[INFO] - Environment 'local' is now active
A continuación, ejecute este comando para iniciar la IU del chat en su navegador predeterminado.
inicio del chat con orchestrate
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 ve en el resultado 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 asemeja al paso 7 de la primera mitad de este tutorial con algunos cambios menores.
Haga clic en el menú desplegable Compartir en la esquina superior derecha de su Langflow y seleccione "Servidor MCP". 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 diferirá del ejemplo anterior. Regrese a su terminal y pegue el siguiente comando usando 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 ingrese 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 Conjunto de herramientas, haga clic en el botón Agregar herramienta. Seleccione “instancia local” para agregar nuestro servidor MCP ya importado, marque la casilla correspondiente al servidor MCP importado y haga clic en Agregar al agente.
5. ¡Empiece a chatear!
Como alternativa a la importación de flujos como servidores MCP, podemos usar ADK para importar flujos como archivos JSON exportados.
1. Este enfoque funciona mejor para flujos simples. Para fines demostrativos, usemos este flujo:
Exporte el flujo a JSON haciendo clic en el botón Compartir y seleccionando Exportar. Ingrese cualquier nombre y descripción para la herramienta/flujo que desee. El nombre de la herramienta debe contener solo caracteres alfanuméricos y guiones bajos, y no debe comenzar con un número ni un guión bajo.
2. Agregue 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 siguiente 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 en 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 nuestros 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: “Encuéntrame 5 trabajos de investigación sobre computación cuántica”.
Resultado:
¡Excelente! El agente determinó que era necesario invocar la herramienta
Este tutorial lo ha equipado con las habilidades esenciales para aprovechar Langflow y watsonx Orchestrate para construir agentes robustos, escalables y listos para la empresa. Aprendió a importar flujos LangFlow agénticos como servidores MCP mediante watsonx Orchestrate como software como servicio (SaaS) junto con IBM Cloud. Además, ahora está familiarizado con cómo importar flujos LangFlow básicos cuando utiliza IBM watsonx Orchestrate Agent Development Kit (ADK) localmente. Al seguir las instrucciones paso a paso, ha aprendido a diseñar, desarrollar y desplegar agentes que invoquen herramientas personalizadas y prediseñadas para resolver las consultas de los usuarios. Con la interfaz visual intuitiva de Langflow, creó flujos de trabajo complejos y watsonx Orchestrate le permitió gestionar y escalar estos agentes de manera eficiente. Como siguiente 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 para mejorar o explorar más.
Si tiene problemas o preguntas, consulte la documentación. Los problemas más comunes se tratan en la guía de resolución de problemas. También puede revisar los problemas de GitHub para ver si otras personas han experimentado problemas similares.
Ponga la IA a trabajar en su negocio con la experiencia en IA líder en la industria y la cartera de soluciones de IBM a su lado.
Reinvente los flujos de trabajo y las operaciones críticas 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, no. 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/.