Creación de flujos de trabajo auténticos

Editar en línea

Un flujo de trabajo agéntico define un conjunto de actividades y controles vinculados que están diseñados para lograr un propósito u objetivo empresarial específico.

Los flujos de trabajo agénticos no se ejecutan a menos que se disponga de un modelo LLM. Si los modelos no están configurados, un administrador debe añadir los modelos necesarios antes de ejecutar los flujos de trabajo agénticos. Para obtener más información, consulta «Selección de un modelo base» y «Gestión de modelos de lenguaje grandes personalizados mediante AI Gateway ».

Acerca de esta tarea

Cuando se crea un flujo de trabajo ágil, se empieza con un nodo inicial y un nodo final. El nodo de inicio es el punto de entrada del flujo de trabajo del agente. Define las entradas necesarias para iniciar la ejecución, como los valores proporcionados por un usuario o un sistema externo. También inicializa las variables del flujo de trabajo que se utilizan a medida que el flujo de trabajo avanza. El nodo final es el punto de salida del flujo de trabajo del agente. Define la salida que se devuelve cuando el flujo de trabajo agéntico completa su ejecución.

El orden en el que cree su flujo de trabajo de Agentic depende de usted. Si conoce los tipos de actividades que desea incluir en su secuencia, puede empezar por añadir esas actividades.

Flujos de trabajo agénticos que se ejecutan de forma asíncrona y pueden ser de larga duración. Cuando ejecuta una herramienta de flujo de trabajo ágil en un chat, usted proporciona las entradas del flujo de trabajo ágil, pero es posible que las salidas del flujo de trabajo ágil no estén disponibles inmediatamente. Utilice la herramienta de utilidad Obtener estado del flujo que se proporciona para comprobar el estado de la herramienta en cualquier momento y para recuperar las salidas de la herramienta.

Consejo:

Si has añadido un campo de entrada en un flujo de trabajo de agente y quieres asegurarte de que el agente solicite ese dato, marca el campo como obligatorio. Si tiene tipos de entrada anidados, marque la entrada como obligatoria para las propiedades anidadas que desea que el agente solicite. Si una entrada o propiedad tiene un valor por defecto, el agente puede utilizarlo en lugar de preguntar al usuario por un valor.

Crear un flujo de trabajo agéntico

Se puede crear un flujo de trabajo para un agente específico o añadirlo directamente al sistema.

Para crear un flujo de trabajo agéntico en el sistema:

  1. En el menú Menú, ve a «Compilar ».

  2. Vaya a Todas las herramientas.

    En un entorno de IBM Cloud, selecciona el espacio de trabajo en el que deseas crear el flujo de trabajo de la lista de espacios de trabajo.

    Puedes elegir un espacio de trabajo global o uno privado, o crear uno nuevo, en función de tus roles y de los permisos a nivel de espacio de trabajo. Todos los flujos de trabajo que crees estarán vinculados y serán visibles únicamente dentro del espacio de trabajo seleccionado.

  3. Seleccione una herramienta existente o haga clic en Crear herramienta + para añadir una nueva herramienta.

  4. Seleccione el flujo de trabajo Agentic.

  5. Introduzca un nombre significativo para el flujo de trabajo.

  6. Haga clic en «Empezar a construir ». Se abrirá el editor de flujos; desde aquí puedes empezar a crear tu flujo de trabajo de Agent.

Para crear un flujo de trabajo para un agente:

  1. En el menú Menú, ve a «Compilar ».

  2. Vaya a Todos los agentes.

    En un entorno de IBM Cloud, selecciona el espacio de trabajo asociado a tu agente en la lista de espacios de trabajo.

  3. Busque y haga clic en su agente.

  4. Desde el conjunto de herramientas del agente, en la sección Conjunto de herramientas, haga clic en Agregar herramienta.

  5. Haga clic en Flujo de trabajo agentico.

  6. Introduzca un nombre significativo para el flujo de trabajo.

  7. Haga clic en «Empezar a construir ». Se abrirá el editor de flujos; desde aquí puedes empezar a crear tu flujo de trabajo de Agent.

Editar detalles del flujo de trabajo de Agentic

Para editar los detalles del flujo de trabajo:

  1. En el menú Menú, ve a «Compilar ».

  2. Vaya a Todas las herramientas.

    En un entorno de IBM Cloud, selecciona el espacio de trabajo asociado al flujo de trabajo en la lista de espacios de trabajo.

  3. Selecciona el flujo de trabajo, haz clic en el icono de Opciones icono de opciones y selecciona «Editar detalles ».

  4. En la pestaña «Descripción general», actualiza el nombre e introduce una descripción de la herramienta.

  5. Haz clic en la pestaña «Parámetros» para configurar las entradas y salidas de la herramienta.

  6. Haga clic en Añadir entradas para definir la entrada. Para obtener instrucciones detalladas, consulte Añadir entradas

  7. Haga clic en Añadir salidas para definir la salida. Para obtener instrucciones detalladas, consulte Añadir salidas

  8. Pulse Listo.

Ejemplos de flujos de trabajo agenticos

Puedes descargar ejemplos de flujos de trabajo de Agentics en https://github.com/IBM/ibm-watsonx-orchestrate-adk/tree/main/examples/flow_builder. Para obtener información sobre cómo importar flujos de trabajo a tu entorno de watsonx Orchestrate, consulta la sección «Creación de flujos de trabajo de agente» en la documentación del ADK.

Configurar valores de flujo de trabajo

La configuración del flujo de trabajo te permite asignar automáticamente el historial de chat a las entradas de los nodos y personalizar cómo se resumen los datos en conversaciones extensas.

Para configurar los ajustes del flujo de trabajo:

  1. En el generador de flujos de trabajo, haz clic valores en situado a la derecha del subtítulo.

  2. La opción Auto-map del historial de chat a entradas está activada por defecto, lo que asigna automáticamente los últimos cinco turnos de conversación del historial de chat como entradas del nodo.

  3. Si elige personalizar las instrucciones de resumen, haga clic en Editar junto a Instrucciones de resumen personalizadas.

    1. Introduzca la instrucción de resumen. Indique las pautas pertinentes, como los datos clave que deben mantenerse sin cambios y el contenido que se puede omitir sin problema para reducir el tamaño.

    2. Pulse Guardar.

Añadir herramientas

Puede añadir herramientas a un flujo de trabajo de agente para ampliar las capacidades de un agente. Para obtener más información, consulte Añadir herramientas.

Añadir agentes

Puede añadir agentes a un flujo de trabajo de agentes para gestionar acciones específicas de tareas dentro del flujo. Para obtener más información, consulte Añadir agentes.

Configurar los controles del flujo de trabajo

Los controles de flujo de trabajo agéntico definen la ruta de ejecución de un flujo de trabajo agéntico. Al configurar los controles del flujo de trabajo agentic, puede establecer condiciones, ramas y bucles que determinen cómo se mueven los datos entre los nodos.

Añadir un control de rama

Una rama controla el camino que se sigue en un flujo de trabajo agentico. La ruta se define en función de las condiciones especificadas. Puede definir múltiples rutas y condiciones de ruta para la rama. Si no se cumple ninguna de las condiciones, el flujo de trabajo agentico sigue la ruta por defecto.

Para añadir una rama al flujo de trabajo agentic:

  1. Para crear una rama

    • Haz clic en el icono Añadir icono. En la pestaña Nodos de flujo, haga clic y arrastre el control Ramificación al lienzo. Puede soltar el control directamente en una línea de conector o en cualquier lugar del lienzo.

    • Haga clic en la línea de conexión entre los nodos inicial y final. Selecciona Añadir un control de flujo > Ramificación. Se inserta automáticamente una rama en la línea del conector.

  2. La rama está preconfigurada con una sentencia if-else.

Añadir rutas

Para añadir una ruta a una rama:

  1. Haz clic en la rama.

  2. En la ventana de la rama, seleccione Añadir ruta.

Añadir condiciones de ruta

Para añadir una condición a una ruta:

  1. Haz clic en la rama.

  2. Busque la ruta y seleccione Editar condición. Elija una de las siguientes opciones para definir una condición:

    • Para crear una condición utilizando el Generador de condiciones :

      1. En la ventana del Creador de condiciones generador de condiciones, haz clic en icono plus y selecciona una variable de la lista desplegable Variables disponibles.

      2. Haz clic icono plus y selecciona un operador de la lista desplegable.

      3. Haz clic icono plus e introduce un valor.

      4. Pulse Intro. Para añadir más de una condición, seleccione Añadir condición.

    • Para crear una condición mediante el editor de expresiones :

      1. Selecciona el editor de expresiones Editor de expresiones.

      2. Haga clic en Introducir expresión e introduzca la expresión Python.

  3. Vuelve a hacer clic.

Editar o eliminar una condición

Para editar las condiciones de una ruta:

  1. Haz clic en la rama.

  2. Busque la ruta y seleccione Editar condición. Elija una de las siguientes opciones para editar una condición:

    • Para editar una condición mediante el Constructor de condiciones :

      1. Actualiza la variable, el operador y el valor.

      2. Pulsa intro.

    • Para editar una condición mediante el editor de expresiones :

      1. Selecciona el editor de expresiones Editor de expresiones.

      2. Haga clic en la expresión para abrir la ventana del editor y actualizar la expresión Python.

Para eliminar la condición de una ruta:

  1. Haz clic en la rama.

  2. Busque la ruta y seleccione Editar condición.

  3. Haz clic en «Eliminar condición eliminar».

Editar rutas

Puede gestionar las rutas de su rama cambiando el orden, renombrando una ruta o eliminándola.

Para cambiar el orden de las rutas:

  1. Haz clic en la rama.

  2. Haz clic en «Más acciones Más acciones».

  3. Seleccione Subir o Bajar en la lista para cambiar el orden.

También puedes cambiar el orden de las rutas haciendo clic y arrastrando el mover icono situado junto a la ruta.

Para editar una ruta:

  1. Haz clic en la rama.

  2. Haz clic en «Más acciones Más acciones».

  3. Seleccione Editar nombre de ruta e introduzca el nuevo nombre.

Para borrar una ruta:

  1. Haz clic en la rama.

  2. Haz clic en «Más acciones Más acciones».

  3. Seleccione Borrar.

Añadir un control «Para cada uno»

A Para cada control ejecuta una serie de acciones para cada elemento de una lista. La variable iterador representa el elemento actual de la lista, y la variable índice indica su posición, partiendo de cero. Puede utilizarlos para acceder y procesar cada elemento de la lista.

Para crear un control «For each», haga lo siguiente:

  • Haz clic en el icono Añadir icono. En la pestaña Nodos de flujo, haga clic y arrastre el control Para cada uno al lienzo. Puede soltar el control directamente en una línea de conector o en cualquier lugar del lienzo.

  • Haga clic en la línea de conexión entre los nodos inicial y final. Selecciona Añadir un control de flujo > Para cada uno. A Para cada control se inserta automáticamente en la línea del conector.

Puede descargar un ejemplo de flujo de trabajo «agentico» relacionado con el control «For each» en https://github.com/IBM/ibm-watsonx-orchestrate-adk/tree/main/examples/flow_builder/recent_transactions. Para obtener más información, consulta «Ejemplos de flujos de trabajo agenticos ».

Lista de selección

Para seleccionar una lista para el Para cada control:

  1. Haga clic en el botón Para cada control.

  2. Utilice una de las siguientes opciones para seleccionar una lista:

    • De forma predeterminada, la función «auto-map» Correlación automática está activada, lo que permite seleccionar un objeto de lista de la entrada del flujo de trabajo de Agent.

Sin embargo, puede cambiar este comportamiento predeterminado y configurar el objeto de lista eligiendo opciones de variables o expresiones.

  • Para configurar un objeto de lista utilizando una variable, seleccione Variable y elija una variable de la lista «Variables disponibles ».

  • Para configurar un objeto de lista mediante una expresión, seleccione Expresión y haga clic en «Introducir expresión» en «Seleccionar un campo de lista» para abrir la ventana del editor y actualizar la expresión « Python ».

Una vez seleccionado el objeto de lista, se proporcionan automáticamente las variables iterador e índice.

Añadir variables locales

Las variables locales sólo se utilizan dentro de un control For each y no son accesibles fuera de él. Cada iteración del For each puede almacenar resultados intermedios específicos de esa iteración. Estos valores se almacenan en su interior y no pueden compartirse entre diferentes iteraciones.

Para añadir variables locales al Para cada control:

  1. Haga clic en el botón Para cada control.

  2. Haz clic Editar detalles en la sección «Variables locales ».

  3. Seleccione Añadir en la ventana Variables locales.

  4. Elija el tipo de variable en la lista desplegable.

  5. Introduzca el Nombre y la Descripción.

  6. Seleccione la casilla Lista de {object type} si desea almacenar una lista de valores en la variable.

  7. Pulse Añadir.

Para añadir más de una variable local, haz clic en «Añadir ».

Editar o eliminar una variable local

Para editar una variable local:

  1. Haga clic en el botón Para cada control.

  2. Haz clic Editar detalles en la sección «Variables locales ».

  3. Pasa el cursor por encima de la variable y selecciona Editar.

  4. Actualice el nombre y la descripción en la ventana Actualizar salida.

  5. Pulse Guardar.

Para eliminar una variable local:

  1. Haga clic en el botón Para cada control.

  2. Haz clic Editar detalles en la sección «Variables locales ».

  3. Pasa el cursor por encima de la variable y selecciona Suprimir.

Configurar actividades

Las actividades definen las acciones que puede realizar un flujo de trabajo. Puede configurar diferentes tipos de x en función de la tarea que desee realizar.

Actividades de los usuarios

Puede utilizar la actividad del usuario para crear una interacción basada en el chat para recopilar información y mostrar el resultado dentro de un flujo de trabajo agentic. Para obtener más información, consulta «Añadir actividades de usuario ».

Para ver un vídeo de ejemplo sobre cómo añadir actividades de usuario, consulta «Creación de un flujo de trabajo agentic con actividades de usuario» en watsonx Orchestrate, en la sección «Vídeos ».

Bloques lógicos

Puede utilizar el bloque lógico para añadir lógica personalizada Python directamente dentro de un flujo de trabajo de Agentic. Para obtener más información, consulta «Añadir bloques lógicos ».

Sugerencias generativas

Puede utilizar un aviso generativo cuando necesite ayuda con tareas que impliquen la comprensión del lenguaje natural. Funciona utilizando un gran modelo lingüístico (LLM) para generar texto o contenido estructurado. Para los avisos generativos en flujos de trabajo agénticos, puede añadir nuevos modelos a través de AI Gateway. Para obtener más información, consulta «Añadir indicaciones generativas ».

Para ver un vídeo de ejemplo sobre cómo añadir indicaciones generativas, consulta «Creación de un flujo de trabajo autónomo con indicaciones generativas» en « watsonx Orchestrate », en la sección «Vídeos ».

Clasificadores de documentos

Puede añadir clasificadores de documentos a los flujos de trabajo de Agentic para identificar automáticamente los tipos de documentos. Para obtener más información, consulta «Añadir clasificadores de documentos ».

Extractores de documentos

Puede añadir extractores de documentos a los flujos de trabajo de agentic para extraer campos o entidades como fecha, nombres y otros de los documentos. Para obtener más información, consulta la sección «Añadir extractores de documentos ».

Extractores de texto

Puede utilizar un extractor de texto en un flujo de trabajo ágil para extraer texto de un documento. Para obtener más información, consulta la sección «Añadir extractores de texto ».

Inspector de flujos

Flow Inspector ofrece una vista general del historial de ejecución de los flujos de trabajo de los agentes, lo que le permite revisar cómo se ha ejecutado un flujo de trabajo de principio a fin. Puede examinar las secuencias de ejecución, analizar los datos intercambiados entre pasos y diagnosticar errores o comportamientos inesperados. Para obtener información detallada sobre las funciones y capacidades del inspector de flujos, consulte «Inspección de flujos de trabajo de agentes ».

Entradas y salidas

Las entradas son los valores externos que se pasan al flujo de trabajo del agente en tiempo de ejecución. Proporcionan la información inicial necesaria para que el flujo de trabajo del agente comience a ejecutarse. Los datos de entrada pueden incluir valores proporcionados por el usuario, valores del sistema o datos recibidos de otro proceso.

Los resultados son lo que se obtiene cuando finaliza la ejecución de un flujo de trabajo autónomo. Definen la información que devuelve el flujo de trabajo del agente, como los datos procesados o las respuestas a los nodos anteriores. Los resultados permiten reutilizar los resultados del flujo de trabajo autónomo en otros procesos, herramientas o flujos de trabajo.

Añadir entradas

Para añadir entradas de flujo de trabajo de Agentic:

  1. Haz clic en el nodo de inicio.

  2. En la ventana Entradas, haga clic en Añadir.

  3. Seleccione un tipo de entrada de la lista.

  4. Introduzca un Nombre y una Descripción.

  5. Opcional: Seleccione la casilla de verificación Lista de {data type} para almacenar una lista de valores en la entrada.

  6. Opcional: Active el interruptor de cambio Establecer valores predeterminados para establecer la entrada con un valor predeterminado.

  7. Introduce un valor y haz clic Terminado en en el campo de valor predeterminado.

  8. Pulse Añadir.

    • Si marca la casilla «Lista de valores predeterminados» ( {data type} ), podrá añadir más de un valor predeterminado en el campo «Lista de valores predeterminados».

    • La casilla de verificación «Lista de {data type} » no está disponible para entradas de archivos, y la opción «Establecer valor predeterminado» no está disponible para entradas de archivos y objetos.

    • En el caso de los tipos de datos de objeto, puedes elegir entre la vista «Simple» y la vista «JSON» para ver las propiedades del objeto.

Añadir salidas

Para añadir salidas de flujo de trabajo de Agentic:

  1. Pulse en el nodo Finalización.

  2. En la ventana Salidas, haga clic en Añadir.

  3. Seleccione el tipo de salida en la lista.

  4. Opcional: Seleccione la casilla de verificación Lista de {data type} para generar una lista de valores como salida.

  5. Pulse Añadir.

    • La casilla de verificación «Lista de {data type} » no está disponible para las entradas de archivos.

    • En el caso de los tipos de datos de objeto, puedes elegir entre la vista «Simple» y la vista «JSON» para ver las propiedades del objeto.

Variables de flujo en un flujo de trabajo ágil

Las variables de flujo se utilizan mientras se ejecuta un flujo de trabajo ágil. Puede seleccionar entre las opciones disponibles o definir variables personalizadas. Permiten compartir datos entre nodos, con valores intermedios conservados y disponibles en diferentes etapas. Las variables de flujo son accesibles a lo largo de todo el flujo de trabajo del agente y pueden ser compartidas y actualizadas entre nodos.

Añadir variables de flujo

Para añadir variables de flujo:

  1. Haz clic en variables de flujo el icono situado a la izquierda de la ventana del flujo de trabajo de agentes.

  2. Haga clic en Añadir y seleccione el tipo de variable de la lista.

  3. Introduzca un Nombre y una Descripción.

  4. Opcional: Seleccione la casilla de verificación Lista de {data type} para almacenar una lista de valores en la variable.

  5. Opcional: Active el interruptor Set default values (Establecer valores predeterminados) para establecer la variable con un valor predeterminado.

  6. Introduce un valor y haz clic Terminado en en el campo de valor predeterminado.

  7. Pulse Añadir.

    • Si marca la casilla «Lista de valores predeterminados» ( {data type} ), podrá añadir más de un valor predeterminado en el campo «Lista de valores predeterminados».

    • La opción Establecer valor predeterminado no está disponible para variables de archivo, objeto y usuario.

    • En el caso de los tipos de datos de objeto, puedes elegir entre la vista «Simple» y la vista «JSON» para ver las propiedades del objeto.

Tipos de entradas, salidas y variables

La siguiente tabla enumera las entradas, salidas y tipos de variables disponibles en un flujo de trabajo agéntico:

Tipo

Descripción

Booleano

Para definir entradas, salidas o variables que requieren un valor verdadero o falso

Fecha/hora

Para definir una fecha, una hora o un valor que combine fecha y hora. Los valores de fecha siguen el formato mm/dd/aaaa. Los valores de hora se expresan en el formato hh:mm con un indicador de AM/PM. En cuanto a la hora y la fecha, también puedes seleccionar una zona horaria de la lista que se proporciona.

Decimal

Para definir valores numéricos que incluyan decimales

Archivo

Definir un archivo que se puede pasar dentro o fuera de un flujo. Se puede utilizar para cargar o descargar archivos, procesar documentos o transferir archivos hacia o desde una herramienta dentro del flujo.

Entero

Para definir valores numéricos enteros

Objecto

Para definir las propiedades de los objetos de entrada, salida o variables mediante el esquema JSON

Serie

Para definir entradas, salidas o variables basadas en texto

Usuario

Para definir variables que almacenan detalles relacionados con el usuario
Consejo:

  • El tipo de datos Usuario solo está disponible para variables de flujo y actualmente no es compatible con entradas ni salidas de flujo.

Requisitos previos para utilizar el tipo de datos de usuario en un flujo de trabajo de agente

Puede utilizar el tipo de datos de usuario para definir variables que contengan los detalles de los usuarios del inquilino. Antes de poder enumerar los usuarios inquilinos en un flujo de trabajo de agente, debe configurar el acceso a las API de la plataforma IBM Cloud.

Como administrador de inquilinos, siga los siguientes pasos para configurar el acceso:

  1. Cree un ID de servicio o un usuario que represente su aplicación o flujo de trabajo. Para obtener más información, consulte la sección «Gestión de identificadores de servicio ».

  2. Genera una clave API para el ID del servicio. Para obtener más información, consulta «Gestión de claves API de Service ID ».

  3. Asigne las siguientes funciones al ID de servicio o al usuario:

    • Función de administrador, limitada al inquilino wxO de destino como recurso

    • Rol de espectador para todos los servicios de gestión de cuentas de IAM

Para obtener más información sobre la asignación de roles, consulte «Gestión del acceso a los recursos ». Una vez asignados estos roles, registra la clave API del ID de servicio o del usuario como conexión con el ID de WXO_PLATFORM_USER_APIaplicación predefinido.

Este requisito previo solo es necesario para los inquilinos de watsonx Orchestrate alojados en IBM Cloud.

Configuración de la conexión

Una vez que haya completado los requisitos previos, siga estos pasos para configurar la conexión:

  1. Activa tu entorno de inquilino.

    orchestrate env activate

  2. Añadir la conexión.

    orchestrate connections add -a WXO_PLATFORM_USER_API

  3. Configure la conexión para los entornos de prueba y producción.

    orchestrate connections configure -a WXO_PLATFORM_USER_API --env draft -t -k <api_key> orchestrate connections configure -a WXO_PLATFORM_USER_API --env live -t -k <api_key>
  4. Configure las credenciales de la clave API.

    orchestrate connections set-credentials -a WXO_PLATFORM_USER_API --env draft --api-key <api_key> orchestrate connections set-credentials -a WXO_PLATFORM_USER_API --env live --api-key <api_key>

Una vez completada la configuración, tu flujo de trabajo de Agentic podrá acceder de forma segura a los datos de los usuarios del tenant mediante el tipo de datos «user».

Añadir propiedades a un tipo de datos de objeto

Puede añadir propiedades a un tipo de datos de objeto para entradas, salidas y variables.

Para añadir propiedades a un tipo de datos de objeto:

  1. Seleccione el tipo de datos Objeto en la lista.

  2. Introduzca un Nombre y una Descripción.

  3. Opcional: Seleccione la casilla Lista de objetos para almacenar una lista de valores en el tipo de datos del objeto.

  4. Haz clic más junto al nombre del objeto en el árbol de objetos o haz clic en «Añadir» (+) en la sección «Propiedades del objeto ».

  5. Seleccione una propiedad de la lista.

  6. Introduzca un Nombre y una Descripción.

  7. Opcional: Seleccione la casilla de verificación Lista de {data type} para almacenar una lista de valores en la propiedad del objeto.

  8. Opcional: Active el interruptor Set default values (Establecer valores predeterminados) para establecer las propiedades con un valor predeterminado.

  9. Introduce un valor y haz clic Terminado en en el campo de valor predeterminado.

  10. Puede elegir entre la vista simple y la vista JSON para ver las propiedades del objeto.

  11. Pulse Guardar.

La opción Establecer valor predeterminado no está disponible para la variable de objeto.

Tipos de datos de objetos

Cuando defina un objeto, tenga en cuenta los siguientes elementos. Un objeto incluye un nombre, una descripción opcional y un conjunto de propiedades definidas mediante un subconjunto simplificado del estándar JSON Schema. Para obtener más información, consulta la documentación del esquema JSON.

Las propiedades pueden ser objetos con sus propias propiedades anidadas. También pueden ser listas, que se definen utilizando el tipo de matriz del esquema JSON.

A continuación se muestra un ejemplo que muestra las propiedades de un objeto Employee definido mediante un esquema JSON

{
    "id": {
        "type": "integer",
        "description": "Unique identifier for the employee"
    },
    "firstName": {
        "type": "string",
        "description": "Employee's first name"
    },

    "lastName": {
        "type": "string",
        "description": "Employee's last name"
    },
    "email": {
        "type": "string",
        "description": "Employee's email address"
    },
    "department": {
        "type": "string",
        "description": "Employee's department"
    },
    "salary": {
        "type": "number",
        "description": "Employee's salary"
    },
    "isActive": {
        "type": "boolean",
        "description": "Whether the employee is currently active"
    },
    "startDate": {
        "type": "string",
        "format": "date",
        "description": "Employee's start date"
    },
    "badges": {
        "type": "array",
        "items": {
            "type": "string"
        },
        "description": "Employee's badges"
    },
    "address": {
        "type": "object",
        "properties": {
            "street": {
                "type": "string"
            },
            "city": {
                "type": "string"
            },
            "zipCode": {
                "type": "string"
            }
        }
    }
}

El esquema del objeto empleado incluye las siguientes propiedades:

  • id, email, salary isActive, y startDate son propiedades simples que contienen valores enteros, cadenas, decimales, booleanos y fechas.

  • address es una propiedad de objeto con propiedades anidadas: calle, ciudad y zipCode.

  • badges es una lista, expresada como una matriz JSON Schema de valores de cadena.

Puedes descargar un ejemplo de flujo de trabajo de Agentics relacionado con el tipo de datos «Object» en https://github.com/IBM/ibm-watsonx-orchestrate-adk/tree/main/examples/flow_builder/Employee_information. Para obtener más información, consulta «Ejemplos de flujos de trabajo agenticos ».

Correlacionar datos

Los nodos dentro de un flujo de trabajo agéntico pueden requerir datos como entrada. Estos datos pueden proceder de las entradas en el flujo de trabajo del agente, de las salidas de los nodos anteriores y del contexto de la sesión de chat.

Cuando un flujo de trabajo agéntico se completa, también puede producir datos como salida. Los datos producidos por el agentic workflow pueden provenir de las entradas del agentic workflow o de nodos dentro del agentic workflow.

Por defecto, cuando un nodo requiere datos como entrada, el motor de flujo de trabajo de agentic intenta identificar posibles fuentes de datos. Si el motor de flujo de trabajo agéntico localiza una fuente, asigna automáticamente esos datos al nodo. Sin embargo, puede anular este comportamiento por defecto y proporcionar un mapeo en los nodos o en la salida del flujo de trabajo agentic. Para anular el comportamiento de la asignación para la salida del flujo de trabajo agéntico, seleccione el nodo Fin del flujo de trabajo agéntico.

Para editar la asignación de datos en un flujo de trabajo de Agentic, seleccione el nodo y haga clic en Editar asignación de datos.

Existen las siguientes opciones de asignación de datos:

  • Mapeo automático: Un flujo de trabajo agéntico mapea automáticamente los datos entre los pasos conectando las entradas de los nodos a las salidas de otros nodos o a las propias entradas del flujo de trabajo agéntico. Si un dato requerido no es producido por ningún nodo dentro del flujo de trabajo agéntico, puedes definir una entrada a nivel de flujo de trabajo agéntico con el mismo nombre y tipo. A continuación, el motor de flujo de trabajo ágil lo mapea automáticamente, lo que puede garantizar una transferencia de datos fluida a lo largo del flujo de trabajo ágil.

Uso del contexto de la sesión de chat en la asignación automática

Anteriormente, los flujos de trabajo de los agentes no tenían acceso automático a la información introducida en el chat antes de que se activara el flujo de trabajo. Para poner la información a disposición del flujo de trabajo, había que definir entradas de flujo e indicar al agente que las rellenara desde el contexto del chat. Ese proceso ya no es necesario y ahora los flujos de trabajo pueden acceder fácilmente a la información más reciente en el contexto del chat.

Al activar el contexto de la sesión de chat, se incluyen los últimos cinco turnos de conversación del historial del chat. Un turno de conversación se refiere a un único intercambio entre un usuario y el agente en un chat.

Los flujos de trabajo de Agentic admiten esta función de forma predeterminada. Si quieres desactivarla o comprobar si está habilitada para tu flujo de trabajo específico:

  1. Abra el flujo de trabajo agéntico.

  2. Haz clic en el icono de Icono ValoresAjustes.

  3. Utiliza el interruptor Mapa automático del historial de chat a entradas para activar o desactivar la función.

Si la autoasignación no tiene éxito, puede pedir al usuario que introduzca los datos necesarios en un chat. Para activar este comportamiento, active la opción Pedir información al usuario si la asignación automática no se realiza correctamente.

Correlación automática

  • Parámetros en blanco: para establecer un parámetro en blanco, desactive la opción «Auto-map» del parámetro del nodo. Si los parámetros de entrada para un nodo en un flujo de trabajo agéntico se dejan vacíos o en blanco, entonces no se pasa ningún valor al parámetro de entrada a lo largo del flujo de trabajo agéntico.

Parámetro en blanco

  • Python expresiones: Puede añadir expresiones Python para parámetros de nodo en un flujo de trabajo agentic.

Expresión

  • Variables: Puede añadir variables para los parámetros de los nodos en un flujo de trabajo agentic.

Variables

  • Valores literales: Puede añadir un valor literal específico para el tiempo de ejecución del flujo de trabajo agentic, como un número o una fecha, a los parámetros de nodo en un flujo de trabajo agentic. Para añadir un valor literal, cierre la opción Auto-mapa del parámetro de nodo. La opción de establecer un valor por defecto no está disponible para los parámetros que se asignan a valores literales.

Valor literal

  • Valores por defecto: Puede añadir un valor predeterminado específico a los parámetros de nodo en un flujo de trabajo agentic. La opción de establecer un valor por defecto no está disponible para los parámetros que se asignan a valores literales.

Valor predeterminado

Formato de fecha y hora para bloques de código y expresiones

Cuando definas valores de fecha y hora en bloques de código o expresiones de mapeo de datos, utiliza el formato estándar ISO 8601 con compatibilidad con las zonas horarias de la IANA:

Formato ISO 8601 : YYYY-MM-DDThh:mm:ss±hh:mm[timezone/location]

Ejemplo : 2026-02-19T07:15:00+05:00[Europe/London]

Desglose del formato :

  • Fecha : YYYY (Año), MM (Mes), DD (Día)

  • Hora : hh (Hora), mm (Minutos), ss (Segundos)

  • Separador : una «T» separa los componentes de la fecha y la hora

  • Zona horaria : «Z» (UTC) o una ±hh:mm diferencia horaria

  • Ubicación de la zona horaria : identificador de zona horaria de la IANA entre corchetes (por ejemplo, [Europe/London])

Se recomienda indicar la zona horaria, aunque se puede omitir. Este formato garantiza una clasificación lógica, elimina la ambigüedad y goza de reconocimiento internacional.

Qué hacer a continuación

Su flujo de trabajo agéntico ya está creado. Puede utilizar la vista previa del chat para probar su flujo de trabajo agéntico.

Una actividad de usuario consiste en una o más interacciones basadas en el chat para recopilar datos y mostrar resultados dentro de un flujo de trabajo agéntico.

Un bloque lógico añade lógica personalizada como lógic Python e dentro de su flujo de trabajo de agente.

Un aviso generativo utiliza las capacidades de los grandes modelos lingüísticos (LLM) para realizar tareas.

Un clasificador de documentos identifica automáticamente los tipos de documentos.

Un extractor de documentos obtiene campos y entidades de los documentos.

Un extractor de texto obtiene texto de un documento.