Ejecución de flujos de trabajo de automatización desde acciones en agentes con Azure AI Foundry y Azure Logic Apps (versión preliminar)

Se aplica a: Azure Logic Apps (Consumo)

Cuando tiene una aplicación de inteligencia artificial en Azure AI Foundry que necesita automatizar procesos de varios pasos o integrarse con varios servicios, sistemas, aplicaciones y orígenes de datos, puede agregar acciones en agentes para ejecutar flujos de trabajo de automatización en Azure Logic Apps.

En Azure AI Foundry, un agente usa una acción y un modelo de IA para completar de forma autónoma o interactiva una tarea. Por ejemplo, los agentes usan acciones para responder a preguntas, obtener información y realizar otros trabajos mediante modelos de IA.

En Azure Logic Apps, un flujo de trabajo de aplicación lógica automatiza los procesos y puede integrar Azure, Microsoft y servicios, sistemas, aplicaciones y orígenes de datos en otros ecosistemas, normalmente sin código adicional. El flujo de trabajo usa un desencadenador y acciones creados previamente desde una galería con más de 1400 conectores junto con operaciones nativas o "integradas" en tiempo de ejecución.

En el diagrama siguiente se muestra cómo una acción en un agente de Azure AI Foundry se relaciona con un flujo de trabajo de aplicación lógica en Azure Logic Apps:

En esta guía se muestra cómo agregar una acción a un agente en Fundición de IA de Azure para que el agente cree un flujo de trabajo de aplicación lógica de consumo que se ejecute en Azure Logic Apps multiinquilino. Un asistente le guía por los pasos para configurar esta acción con un flujo de trabajo de aplicación lógica predefinido. Después de terminar de agregar la acción, puede ampliar este flujo de trabajo, en función de las necesidades del escenario, mediante el diseñador gráfico de Azure Logic Apps.

Para más información, consulte la siguiente documentación:

• ¿Qué es Azure AI Foundry?
• ¿Qué es Azure Logic Apps?
• Flujo de trabajo de aplicación lógica de consumo: Opciones de hospedaje

Prerrequisitos

• Una cuenta y una suscripción de Azure. Si no tiene una suscripción de Azure, regístrese para obtener una cuenta gratuita de Azure.

• Un proyecto de Azure AI Foundry, que se crea con un centro predeterminado.

  Este proyecto organiza tu trabajo y guarda el estado mientras desarrollas tus aplicaciones de IA. El centro hospeda el proyecto y proporciona un entorno de colaboración de equipo.

  Para crear un proyecto con un centro de conectividad, necesita uno de los siguientes roles para el control de acceso basado en rol (RBAC) de Microsoft Entra, en función del principio de privilegios mínimos:

  • Colaborador (privilegio mínimo)

  • Propietario

  Si tiene algún otro rol, debe tener el centro creado automáticamente. Para más información, consulte la siguiente documentación:

  • Roles predeterminados para proyectos

  • Roles predeterminados para centros

• Un modelo de servicio OpenAI de Azure implementado para el proyecto.

  Si no tiene un modelo implementado, consulte Implementación de un modelo.

• Un agente en el proyecto.

  Este requisito incluye la implementación de un modelo en el servicio Azure OpenAI para que el agente lo use mientras se ejecuta el flujo de trabajo.

¿Puedo crear y usar mis propios flujos de trabajo como acciones?

Sí, para que sus propios flujos de trabajo de aplicación lógica estén disponibles a través de la galería de acciones en el portal de Azure AI Foundry, los flujos de trabajo deben cumplir los siguientes requisitos:

• El recurso de aplicación lógica que contiene el flujo de trabajo usa la opción de hospedaje Consumo.

• El recurso de aplicación lógica usa la misma suscripción de Azure que se usa con Azure AI Foundry.

• El flujo de trabajo comienza con el desencadenador denominado Cuando se recibe una solicitud HTTP.

• El desencadenador incluye una descripción, que se proporciona en el panel de información del desencadenador en el diseñador de flujo de trabajo.

• El flujo de trabajo finaliza con la acción Respuesta.

La aplicación de inteligencia artificial tiene casi infinitas opciones para ejecutar flujos de trabajo que interactúan con Azure, Microsoft y otros servicios o productos, además de operaciones que le ayudan a administrar, dar forma, convertir y transformar datos. Si no existe ningún conector predefinido para lo que desea hacer, también puede crear el suyo propio.

El diagrama de arquitectura muestra el portal de Azure AI Foundry con un agente de IA de ejemplo y una acción conectados al portal de Azure con Apps lógicas de Azure multitenant y un flujo de trabajo de aplicación lógica de ejemplo que puede acceder a las API de Azure, Microsoft y REST para otros servicios y sistemas.

Para más información, consulte la siguiente documentación:

• Inicio rápido: Creación de un ejemplo de flujo de trabajo de aplicación lógica de Consumo mediante Azure Portal
• ¿Qué son los conectores en Azure Logic Apps?
• Conectores administrados que se ejecutan en Azure global y multiinquilino
• Referencia técnica de conectores administrados para Azure Logic Apps
• Operaciones integradas que se ejecutan con el entorno de ejecución de Azure Logic Apps
• Conectores personalizados en Azure Logic Apps

Limitaciones y problemas conocidos

Esta versión tiene las siguientes limitaciones o problemas conocidos:

Adición de una acción al agente

Siga estos pasos para configurar una acción para que el agente cree y ejecute un flujo de trabajo de aplicación lógica.

1. Inicie sesión en el portal de Azure AI Foundry y abra el proyecto.

2. En la información general del proyecto, en el menú de navegación del portal, en Compilar y personalizar, seleccione Agentes. En la página Agentes , en Mis agentes, seleccione el agente.

   

3. En la sección Configuración junto a la lista de agentes, desplácese hacia abajo hasta la sección Acciones y seleccione Agregar.

   

4. En la ventana Agregar acción , seleccione Azure Logic Apps.

   

5. En Seleccionar una acción, seleccione una acción predefinida con una de las etiquetas siguientes:

   Etiqueta de acción	Descripción
   Autorizado por Microsoft	Esta acción usa una plantilla creada por Microsoft para crear el flujo de trabajo de la acción.
   Flujo de trabajo	Esta acción usa un flujo de trabajo de aplicación lógica apto en la suscripción de Azure como plantilla para crear el flujo de trabajo de la acción. Nota: Si selecciona esta opción, pase a la sección denominada Confirmar detalles de la acción. Si los flujos de trabajo no aparecen como se esperaba en la galería de acciones, compruebe los requisitos.

   En el ejemplo siguiente se usa la acción proporcionada por Microsoft denominada Obtener la previsión del tiempo para hoy a través de MSN Weather:

   

6. En la ventana Agregar acción de Logic App, en la sección Escriba información básica, proporcione la siguiente información:

   Parámetro	Obligatorio	Importancia	Descripción
   Nombre de la acción	Sí	< action-name>	Un nombre descriptivo, pero centrado en tareas, verbo-primero, conciso para la acción. Este nombre también se usa para el recurso y el flujo de trabajo de la aplicación lógica en Azure Logic Apps. Nota: - El nombre de la acción solo puede usar letras, números y los siguientes caracteres especiales: -, (, ), _o '. - No puede usar espacios en blanco ni otros caracteres especiales. - Un recurso de aplicación lógica de consumo y un flujo de trabajo se combinan y tienen una relación 1:1, por lo que usan el mismo nombre. En comparación, un recurso de aplicación lógica estándar puede tener varios flujos de trabajo que usan nombres diferentes. En este ejemplo se usa Get-weather-forecast-today.
   Descripción de la acción	Sí	< action-description>	Descripción que describe claramente el propósito de la acción. En este ejemplo se usa Esta acción crea un flujo de trabajo de aplicación lógica de Consumo invocable que obtiene la previsión meteorológica de hoy y se ejecuta en Azure Logic Apps global y multiinquilino.
   Suscripción	Sí	< Suscripción de Azure>	La suscripción de Azure que se va a usar, presumiblemente la misma que la de tu proyecto y modelo.
   Grupo de recursos	Sí	< Grupo de recursos de Azure>	El grupo de recursos de Azure que se va a usar.
   Ubicación	Sí	< Región de Azure>	Región de Azure donde hospedar el recurso y el flujo de trabajo de la aplicación lógica.

   En la siguiente captura de pantalla se muestran los detalles de la acción de muestra Get-weather-forecast-today:

   

7. Cuando haya acabado, seleccione Siguiente.

Creación y autenticación de conexiones

Siga estos pasos para crear las conexiones que la acción necesita y autenticar el acceso a los servicios, sistemas, aplicaciones o orígenes de datos pertinentes. La plantilla subyacente especifica los conectores que se usarán para esta acción y el flujo de trabajo de la aplicación lógica.

1. En la ventana Agregar acción de la aplicación lógica, en Autenticar, revise las conexiones que necesite para crear y autenticar.

2. En la columna Conexión , seleccione Conectar para el servicio relacionado o el origen de datos.

   En la captura de pantalla siguiente se muestra la conexión de ejemplo para crear y autenticar para el servicio Weather de MSN:

   

   Algunas conexiones requieren más detalles, así que siga las indicaciones para proporcionar la información solicitada.

3. Para cada conexión necesaria, repita estos pasos.

4. Cuando haya acabado, seleccione Siguiente.

Confirmar los detalles de la acción

Revise y compruebe que toda la información de acción aparece correcta. Si seleccionó una acción creada por Microsoft, revise y dé su consentimiento a la declaración de reconocimiento.

1. En la ventana Agregar acción de aplicación lógica, en Recurso, compruebe toda la información proporcionada sobre la acción.

2. Para una acción seleccionada creada por Microsoft, complete los siguientes pasos:

   1. Revise la instrucción que confirma y comprende los siguientes eventos que se producen después de salir de la página Recurso ; para ello, seleccione Siguiente:

      • No puede volver a los pasos anteriores.

      • La acción crea un recurso de aplicación lógica de Consumo.

      • La conexión a Azure Logic Apps conlleva cargos en su cuenta de Azure.

        Para obtener más información sobre el modelo de facturación para flujos de trabajo de aplicaciones lógicas de consumo, consulte la siguiente documentación:

        • Medición de uso, facturación y precios

        • Precios de Azure Logic Apps (plan de consumo: multiinquilino)

   2. Para dar su consentimiento, seleccione el cuadro de confirmación, por ejemplo:

      

3. Cuando esté listo, seleccione Siguiente.

Finalizar la creación de la acción

Para el paso final, revise la información que genera el portal sobre la herramienta que usa el agente para ejecutar la acción y autenticar el acceso a los servicios o recursos de Azure, Microsoft y que no son de Microsoft pertinentes.

1. En la ventana Agregar acción de Logic App, en la página Esquema, revise la siguiente información y asegúrese de proporcionar una descripción sobre las circunstancias para llamar a la herramienta.

   Parámetro	Descripción
   Nombre de la herramienta	Nombre editable de la herramienta que usa el agente para ejecutar la acción y acceder a Azure, Microsoft, servicios externos, orígenes de datos o modelos de inteligencia artificial especializados para que el agente pueda obtener datos, ejecutar tareas e interactuar con otras plataformas. Nota: : el nombre de la acción solo puede usar letras, números y el carácter de subrayado (_). - No puede usar espacios en blanco ni otros caracteres especiales.
   Conexión para la autenticación	Nombre de solo lectura de la conexión que usa el agente para acceder a Azure, Microsoft y recursos externos sin tener que solicitar credenciales cada vez. Para más información, vea Conexiones en el portal de Azure AI Foundry.
   Describir cómo invocar la herramienta	Descripción que especifica las circunstancias para cuando el agente llama a la herramienta.
   Esquema	Esquema del flujo de trabajo de la aplicación lógica en formato de notación de objetos JavaScript (JSON).

   

2. Cuando esté listo, seleccione Crear.

   El portal le devuelve a la página Agentes del agente seleccionado. En la sección Configuración , la sección Acciones muestra ahora el nombre de la herramienta que ejecuta la acción y muestra el icono de Azure Logic Apps junto al nombre de la herramienta, por ejemplo:

   

Prueba de la acción del agente

Para probar la nueva acción del agente mediante el Área de juegos Agentes, siga estos pasos:

1. En la página Agentes , en la parte superior de la sección Configuración , seleccione Probar en el área de juegos.

2. En la página Área de juegos Agentes, en el cuadro de chat de consulta de usuario, haga una pregunta sobre el tiempo, por ejemplo:

   ¿Cuál es el tiempo en Londres? Muestra los resultados en formato de lista de viñetas.

   El agente devuelve una respuesta similar al ejemplo siguiente:

   

Revisión de la aplicación lógica subyacente y el flujo de trabajo

Una vez que se ejecute la acción, puede ver el recurso de aplicación lógica subyacente y el flujo de trabajo en Azure Portal. Puede revisar el historial de ejecución del flujo de trabajo, que puede usar para depurar o solucionar problemas que puede experimentar el flujo de trabajo.

1. Inicie sesión en Azure Portal. En el cuadro de búsqueda de la barra de título del portal, escriba el nombre de la acción que creó.

2. En la lista de resultados, en Recursos, seleccione el recurso de aplicación lógica.

   

3. Para ver el historial de ejecución, las entradas, las salidas y otra información del flujo de trabajo, en el menú de la aplicación lógica, en Herramientas de desarrollo, seleccione Historial de ejecución.

4. En la lista Historial de ejecuciones, seleccione el último flujo de trabajo ejecutado, por ejemplo:

   

5. Una vez que se abra la vista de supervisión y se muestre el estado de cada operación del flujo de trabajo, seleccione una operación para abrir el panel de información y revise las entradas y salidas de la operación.

   En este ejemplo se selecciona la acción denominada Obtener previsión para hoy, por ejemplo:

   

   Para obtener más información sobre el historial de ejecución del flujo de trabajo, consulte Visualización del estado del flujo de trabajo y historial de ejecución.

Abrir flujo de trabajo en el diseñador

Siga estos pasos para revisar la definición y las operaciones del flujo de trabajo o editar el flujo de trabajo abriendo el diseñador de flujos de trabajo.

1. En el menú aplicación lógica, en Herramientas de desarrollo, seleccione el diseñador.

   El flujo de trabajo se abre en el diseñador. Ahora puede revisar las operaciones del flujo de trabajo, que hacen referencia al desencadenador y las acciones, por ejemplo:

   

2. Para ver los parámetros y la configuración de una operación, en el diseñador, seleccione la operación, por ejemplo:

   

3. Para expandir el comportamiento del flujo de trabajo, puede agregar más acciones siguiendo los pasos descritos en Creación de un flujo de trabajo con un desencadenador o una acción.

   Para que este flujo de trabajo o cualquier otro flujo de trabajo aparezca en la galería de acciones y se ejecute como una acción en un agente, el flujo de trabajo siempre debe cumplir los siguientes requisitos:

   • El recurso de aplicación lógica que contiene el flujo de trabajo debe usar la opción de hospedaje Consumo.

   • El recurso de aplicación lógica debe usar la misma suscripción de Azure que se usa con Azure AI Foundry.

   • El flujo de trabajo debe comenzar con el desencadenador Cuando se recibe una solicitud HTTP.

   • El desencadenador requiere una descripción, que puede encontrar en el panel de información del desencadenador en el diseñador.

   • El flujo de trabajo debe terminar con la acción Respuesta.

   Precaución

   Aunque puede agregar acciones y cambiar el flujo de trabajo, no edite el desencadenador y las acciones originales para evitar interrumpir la relación entre el flujo de trabajo, el agente y la acción. Sus parámetros están configurados para trabajar juntos, por lo que los cambios en estas operaciones corren el riesgo de interrumpir la acción en el agente. En su lugar, considere la posibilidad de crear una versión personalizada o un flujo de trabajo diferente que puede agregar como una acción a un agente.

   Por ejemplo, el desencadenador usa los parámetros siguientes, que son necesarios para llamar al desencadenador:

   Parámetro	Descripción
   Nombre	Este nombre forma parte de la dirección URL HTTPS del desencadenador. Los autores de llamadas externos, como otros servicios, fuera del flujo de trabajo envían una solicitud HTTPS a esta dirección URL, que activa el desencadenador e inicia el flujo de trabajo. El desencadenador es siempre el primer paso de un flujo de trabajo y especifica la condición que se debe cumplir para que se ejecute el desencadenador.
   HTTPS URL	Cuando el flujo de trabajo se guarda por primera vez, esta dirección URL se genera y se usa para llamar a un punto de conexión que el desencadenador crea para el flujo de trabajo.
   Método	Esta configuración especifica si el desencadenador acepta todos o solo métodos HTTPS específicos.
   Esquema JSON del cuerpo de la solicitud	Si desea validar la entrada que el desencadenador espera recibir en la solicitud HTTPS enviada desde autores de llamadas externos, este esquema especifica el esquema JSON que se va a usar para validar esa entrada.

4. Para guardar los cambios que realice, en la barra de herramientas del diseñador, seleccione Guardar.

Prueba de un flujo de trabajo en el diseñador

Si realizó cambios en el flujo de trabajo meteorológico o para probar otro flujo de trabajo, siga estos pasos:

1. En la barra de herramientas del diseñador, seleccione Ejecutar>Ejecutar con carga útil.

2. Una vez que se abra el panel Ejecutar con carga, en el campo Cuerpo, proporcione las entradas de activador esperadas en formato JSON, por ejemplo:

   {
       "location": {
           "type": "London",
           "description": "Location for the weather"
       }
   }
   

3. Cuando esté listo, seleccione Ejecutar.

   En la pestaña Salida, el Cuerpo de la respuesta contiene los resultados y la respuesta del flujo de trabajo.

4. Si la ejecución del flujo de trabajo genera errores o requiere solución de problemas, abra el historial de ejecución del flujo de trabajo para que pueda examinar las entradas y salidas de cada operación mediante los pasos pertinentes de Revisión de la aplicación lógica subyacente y el flujo de trabajo.

Precios y facturación

Los flujos de trabajo de aplicaciones lógicas de consumo incurren en cargos basados en el modelo de facturación de "pago por uso". Para obtener más información sobre este modelo, consulte los siguientes recursos:

• Medición de uso, facturación y precios
• Precios de Azure Logic Apps (plan de consumo: multiinquilino)

Para Azure AI Foundry, consulte los siguientes recursos:

• Planear y administrar los costos de Foundry de Azure AI
• Precios de Azure AI Foundry

Limpieza de recursos

Si no necesita los recursos que ha creado para esta guía, elimine los recursos para que no continúe incurriendo en cargos. Puede seguir estos pasos para eliminar el grupo de recursos que contiene estos recursos o puede eliminar cada recurso individualmente.

1. En el Portal de la Fundición de IA de Azure, para quitar la acción del agente, junto al nombre de la acción, seleccione el botón de puntos suspensivos (...) y, a continuación, seleccione Quitar.

2. En el cuadro de búsqueda de la barra de título de Azure Portal , escriba grupos de recursos y seleccione Grupos de recursos.

3. Busque el grupo de recursos que contiene los recursos del centro de conectividad implementados.

4. En la barra de herramientas de la página Información general, seleccione Eliminar grupo de recursos.

5. Cuando aparezca el panel de confirmación, escriba el nombre del grupo de recursos y seleccione Eliminar.

Contenido relacionado

• ¿Qué son los conectores de Azure Logic Apps?
• ¿Qué es Azure AI Foundry?
• ¿Qué es Azure Logic Apps?