Adición de flujos de trabajo de agente declarativo en Visual Studio Code

Los flujos de trabajo del agente declarativo definen secuencias de acciones predefinidas para los agentes mediante configuraciones en lugar de lógica de programación explícita. En este artículo, agrega flujos de trabajo de Foundry Agent a un agente y los prueba mediante la extensión de Microsoft Foundry para Visual Studio Code (VS Code).

Después de crear un agente en Foundry Agent Service en el portal, puede agregar flujos de trabajo para orquestar varios agentes en secuencias de acciones predefinidas para escenarios complejos de automatización.

Importante

Los elementos marcados (versión preliminar) en este artículo se encuentran actualmente en versión preliminar pública. Esta versión preliminar se ofrece sin un contrato de nivel de servicio y no es aconsejable usarla para cargas de trabajo de producción. Para más información, consulte Términos de uso complementarios para las versiones preliminares de Microsoft Azure.

Prerrequisitos

• Un proyecto Foundry con al menos un agente desplegado. Para crear uno en el portal de Foundry, consulte Inicio rápido: Chat con un agente.
• Al menos un flujo de trabajo creado en el portal de Foundry. Para obtener más información sobre los flujos de trabajo, consulte Flujos de trabajo del Agente Foundry.
• La extensión Microsoft Foundry para Visual Studio Code ha sido instalada.
• Una suscripción de GitHub Copilot (necesaria para convertir flujos de trabajo de YAML al código de Agent Framework).

Visualización de un flujo de trabajo de agente declarativo

Para ver y editar un flujo de trabajo de agente declarativo en VS Code para web, vaya primero al flujo de trabajo en el portal de Foundry:

1. En el portal de Foundry, abra el proyecto que contiene el flujo de trabajo.
2. Seleccione la pestaña Flujos de trabajo en el menú izquierdo.
3. Seleccione el flujo de trabajo que desea abrir.

A continuación, elija una de las siguientes opciones para abrir el flujo de trabajo en VS Code para web.

Apertura del flujo de trabajo de YAML en VS Code para web

1. Seleccione la pestaña Compilar y, a continuación, seleccione el botón YAML en el lado derecho.
2. Seleccione el botón Abrir en VS Code para Web . El archivo YAML de flujo de trabajo se abre en VS Code para el editor web con la definición de YAML a la izquierda y un gráfico de flujo de trabajo visual a la derecha.
3. Edite yaml según sea necesario para modificar el flujo de trabajo. Los cambios se reflejan en el editor visual.
4. Cuando haya terminado, seleccione Implementar en el menú de puntos suspensivos (...) de la esquina superior derecha para guardar los cambios en Foundry.

Abra el código de flujo de trabajo desde el portal de Foundry.

1. Seleccione la pestaña Compilar y, a continuación, seleccione el botón Código en el lado derecho.
2. Seleccione el botón Abrir en VS Code para la Web. El archivo de código de flujo de trabajo se abre en VS Code para el editor web con la definición de código a la izquierda y el gráfico de flujo de trabajo visual de la derecha.
3. Edite el código según sea necesario para modificar el flujo de trabajo. Los cambios se reflejan en el editor visual.
4. Cuando haya terminado, seleccione Implementar en el menú de puntos suspensivos (...) de la esquina superior derecha para guardar los cambios en Foundry.

Prueba de un flujo de trabajo en el área de juegos

Pruebe el flujo de trabajo del agente declarativo mediante el área de juegos del agente remoto en la extensión de VS Code.

1. En la sección Mis recursos de la extensión de VS Code, busque y seleccione el proyecto Foundry.
2. Seleccione Agentes declarativos.
3. Seleccione la versión del flujo de trabajo que desea probar.
4. Se abre el panel Área de juegos del agente remoto e inicia una conversación con el agente.
5. En el cuadro de entrada de la parte inferior del panel Área de juegos del agente remoto , escriba un mensaje y presione Entrar.
6. Revise la respuesta del agente. Compruebe que la respuesta coincide con el comportamiento esperado de las acciones definidas del flujo de trabajo.

Sugerencia

También puede abrir el área de juegos del agente remoto desde la subsección Herramientas y seleccionar el agente en la lista desplegable.

Conversión de un flujo de trabajo DE YAML al código de Agent Framework

Para personalizar los flujos de trabajo basados en YAML, conviértalos en código de Agent Framework con GitHub Copilot.

1. Abra el archivo YAML de flujo de trabajo en VS Code.
2. Seleccione el botón Generar código en la esquina superior derecha del editor de YAML.
3. Seleccione el lenguaje de programación en el que desea generar el código (Python o C#). GitHub Copilot abre un panel con mensajes de generación de código para el lenguaje seleccionado y genera código de Agent Framework basado en la definición de YAML.
4. Cuando GitHub Copilot le pregunte si desea ejecutar el código generado localmente, seleccione Sí para abrir el visualizador local. Puede ver cada paso mientras el agente se ejecuta.
5. Revise y modifique el código generado según sea necesario para ajustarse a sus requisitos.
6. Haga clic con el botón derecho en el archivo de código generado y seleccione Implementar en Foundry para implementar el código en el proyecto foundry.
7. En el portal de Foundry, vaya al proyecto y compruebe que el código aparece en la sección Agentes .

Contenido relacionado

• Flujos de trabajo del agente de Foundry