Uso y migración de flujos de trabajo de agentes declarativos con Microsoft Foundry Toolkit

Use Microsoft Foundry Toolkit para Visual Studio Code para trabajar con flujos de trabajo declarativos existentes y prepararlos para la migración. Puede probar un flujo de trabajo guardado, editar su YAML exportado y usar GitHub Copilot para ayudar a convertir la definición en Microsoft código de Agent Framework.

Importante

Los flujos de trabajo declarativos de Microsoft Foundry se encuentran en versión preliminar y se retiran el 1 de diciembre de 2026. Utilice Microsoft Agent Framework para desarrollar nuevos flujos de trabajo. Esta retirada no afecta a la orquestación basada en código en agentes hospedados. Consulte la guía de migración de flujo de trabajo para ver las rutas de migración admitidas.

Prerequisites

Visualización de un flujo de trabajo de agente declarativo

Busque el flujo de trabajo en la lista de agentes consolidados del proyecto.

  1. En la vista Foundry Toolkit , en Mis recursos, confirme el proyecto Foundry seleccionado.
  2. Seleccione Agentes y, a continuación, seleccione la pestaña Flujo de trabajo .
  3. Seleccione el nombre del flujo de trabajo para abrir su área de juegos.
  4. Use el selector de versiones para elegir la versión guardada que desea inspeccionar.

El área de juegos muestra el gráfico de flujo de trabajo y un área de conversación. El gráfico es de solo lectura. Use el archivo YAML exportado o el portal de Foundry para editar la definición.

Edición de una definición de flujo de trabajo existente

Exporte la definición antes de editarla o migrarla. Mantenga una copia del CÓDIGO YAML original para poder compararlo con los cambios.

  1. Abra el flujo de trabajo existente en el portal de Foundry.
  2. En el diseñador de flujo de trabajo, cambie a la vista YAML y copie o exporte la definición. Para obtener más información, consulte Exportación de la definición del flujo de trabajo.
  3. Guarde la definición en el área de trabajo local con un nombre que termine en .workflow.yaml, como support.workflow.yaml.
  4. Abra el archivo en Visual Studio Code y edite el ARCHIVO YAML.
  5. Guarde el archivo. Los cambios en los archivos locales no actualizan el flujo de trabajo en Foundry.

Guardar una nueva versión del flujo de trabajo existente

Antes de la retirada, puede implementar una definición editada en el mismo flujo de trabajo. Confirme el nombre del proyecto y del flujo de trabajo para evitar la creación de un recurso diferente.

  1. Confirme que el proyecto del flujo de trabajo original está seleccionado en Foundry Toolkit.
  2. Con el .workflow.yaml archivo abierto, seleccione Implementar en la barra de herramientas del editor.
  3. En Escriba el nombre del flujo de trabajo, escriba el nombre del flujo de trabajo existente.
  4. Espere la notificación de que el despliegue se ha completado correctamente.
  5. Vuelva a abrir el flujo de trabajo desde Agentes>Flujo de trabajo y seleccione la nueva versión.

La implementación con un nombre de flujo de trabajo existente crea una nueva versión. Un nombre diferente crea un flujo de trabajo independiente; no uses esta ruta de acceso para iniciar el desarrollo de nuevos flujos de trabajo.

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

Pruebe la versión guardada que planea mantener o migrar. Use las mismas solicitudes más adelante para comparar la implementación migrada.

  1. Abra el área de juegos del flujo de trabajo y seleccione la versión necesaria.
  2. En la pestaña Parque infantil , seleccione Nuevo para iniciar una nueva sesión de área de juegos.
  3. Escriba una solicitud que ejerce el flujo de trabajo y envíela.
  4. Revise la respuesta y el gráfico de ejecución. Confirme que se ejecutan los agentes, ramas y pasos esperados.
  5. Repita el proceso con solicitudes que recorran distintas ramas, entradas faltantes y cualquier paso de aprobación de su flujo de trabajo.

El área de juegos ejecuta el flujo de trabajo de Foundry guardado. No ejecuta cambios no guardados en el archivo YAML local ni en el código que Copilot genera.

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

Utiliza la acción de generación de código del entorno de pruebas para pedirle a GitHub Copilot que convierta la definición del flujo de trabajo seleccionada. El código generado es un punto de partida que debe revisar y probar.

  1. En el entorno de pruebas del flujo de trabajo, seleccione la versión que desea migrar.
  2. Seleccione Generar código.
  3. Elija Python o C#.
  4. Revise la solicitud de conversión en Copilot Chat y siga sus indicaciones para generar el código.
  5. Revise el proyecto generado, las dependencias, las conexiones de modelo, las herramientas y la configuración de autenticación.
  6. Compare su orquestación con el YAML exportado. Revise las ramificaciones, las variables, las llamadas a agentes y los pasos de aprobación humana.
  7. Ejecute el código localmente y pruábelo con las solicitudes que usó para el flujo de trabajo original. Utiliza Agent Inspector para inspeccionar la ejecución.
  8. Cuando el código se comporte según sea necesario, siga Crear agentes hospedados para preparar un proyecto de agente hospedado compatible, implementarlo y probar la versión implementada.

La conversión de código no implementa un agente hospedado ni garantiza un comportamiento equivalente. Mantenga la definición original hasta que complete la migración y confirme que las aplicaciones dependientes usan el reemplazo.

Para ver otras opciones de migración, como YaML declarativo de Agent Framework, Azure Logic Apps y conexiones A2A directas, consulte la guía de migración del flujo de trabajo.

Contenido relacionado

Use estas guías para elegir y completar la migración:

  • Last updated on