Compartir a través de

Ciclo de vida de desarrollo del agente

El ciclo de vida de desarrollo del agente en Microsoft Foundry abarca desde la creación inicial a través de la supervisión de producción. Seguir este ciclo de vida te ayuda a crear agentes confiables, detectar problemas al principio y lanzar con confianza. Use el portal de Foundry o el código para compilar, personalizar y probar el comportamiento del agente. A continuación, recorre en iteración el seguimiento, la evaluación y la supervisión para mejorar la calidad y la confiabilidad. Cuando esté listo, publique el agente como una aplicación de agente para compartirlo e integrarlo en las aplicaciones.

Este artículo es para desarrolladores que desean compilar, probar y enviar agentes listos para producción.

Prerrequisitos

Ciclo de vida de un vistazo

Utilice este ciclo de vida como una lista de comprobación práctica mientras desarrolla y envía un agente.

  1. Elija un tipo de agente: comience con un agente basado en mensajes, un flujo de trabajo o un agente hospedado.
  2. Crea tu agente y empieza a probar: Itera en el entorno de pruebas o en el código.
  3. Agregar herramientas y datos: adjunte herramientas para recuperación y acciones y valide la configuración antes de guardar.
  4. Guardar los cambios como versiones: capture hitos significativos y compare versiones.
  5. Depuración con seguimiento: Use el seguimiento para confirmar las llamadas a herramientas, la latencia y el comportamiento de extremo a extremo. Para obtener más información, consulte Información general sobre el seguimiento del agente.
  6. Evaluar la calidad y la seguridad: ejecute evaluaciones repetibles para detectar regresiones antes de publicar. Para obtener instrucciones conceptuales, consulte Evaluadores de agentes.
  7. Publicar e integrar: publique un punto de conexión estable e intégrelo en la aplicación. Para conocer los pasos, consulte Publicación y uso compartido de agentes en Microsoft Foundry.
  8. Supervisar e iterar: Monitoree el rendimiento y la calidad del producto durante la producción; luego, actualice y publique nuevamente según sea necesario. Para obtener instrucciones, consulte Supervisar la calidad y la seguridad.

Tipos de agente en Microsoft Foundry

Hay tres tipos de agentes:

  • Basado en avisos: un agente basado en avisos es un agente único declarativamente definido que combina la configuración del modelo, las instrucciones, las herramientas y los avisos de lenguaje natural para impulsar el comportamiento. Extiéndalo adjuntando herramientas para el conocimiento y la memoria. Publique, supervise, evalúe, pruebe, versionen y edite agentes basados en mensajes desde la zona de pruebas de agentes en el portal de Foundry.

  • Flujo de trabajo: use flujos de trabajo para crear un flujo de trabajo más avanzado que organice una secuencia de acciones o coordina varios agentes. Los flujos de trabajo tienen su propia interfaz en el portal, pero se aplica el mismo ciclo de vida. Para obtener más información, consulte Compilación de un flujo de trabajo en Microsoft Foundry.

  • Hospedado (versión preliminar): los agentes hospedados son agentes en contenedores que se compilan en código mediante marcos admitidos o código personalizado. Foundry Agent Service implementa y administra estos agentes. No edita los agentes hospedados en la interfaz de usuario de compilación del agente, pero todavía puede invocarlos, evaluarlos, supervisarlos y publicarlos. Para obtener más información, consulte ¿Qué son los agentes hospedados?

Cree agentes y flujos de trabajo basados en mensajes en el portal de Foundry o en su propio entorno de desarrollo mediante la CLI, el SDK o la API REST. Para obtener más información, consulte el inicio rápido.

Creación de un agente basado en indicaciones

Si ya sabe qué tipo de agente desea crear, asígnele el nombre y, a continuación, empiece a configurar sus instrucciones y herramientas de modelo.

Nota:

Después de asignar un nombre al agente, no puede cambiar el nombre. En el código, se refiere a su agente como <agent_name>:<version>.

Desarrollo de agentes en código

Si prefiere trabajar en el código, use formas admitidas de incorporar el código del agente a un entorno de desarrollo desde el que puede probar localmente y, a continuación, implementarlo en Azure.

En la pestaña Código del panel de chat del entorno de pruebas del agente, puede transferir un fragmento de código que hace referencia a su agente a un entorno dedicado de Visual Studio Code para la nube web. El fragmento de código viene preconfigurado con los paquetes y extensiones que necesita, junto con instrucciones para desarrollar e implementar eficazmente el agente de Foundry en Azure. También puede copiar el fragmento de código directamente en su entorno de desarrollo preferido. Para obtener más información, consulte la documentación del área de juegos.

Funcionalidades principales para el ciclo de vida de desarrollo del agente

La experiencia de creación de agentes ofrece experiencias integradas para cada paso básico del ciclo de vida de desarrollo del agente. Use estas funcionalidades principales a medida que desarrolle la aplicación de agente lista para producción. Cada funcionalidad tiene documentación detallada donde puede obtener más información.

Guardar los cambios como versiones

Después de crear la primera versión de un agente basado en mensajes o un flujo de trabajo, guarde los cambios posteriores como nuevas versiones. Puede probar los cambios no guardados en el área de juegos del agente. Pero si desea ver el historial de conversaciones, supervisar el rendimiento del agente o ejecutar evaluaciones completas, debe guardar los cambios.

El control de versiones del agente proporciona las siguientes funcionalidades para administrar configuraciones e iteraciones del agente. Este sistema garantiza que se realice un seguimiento de todos los cambios, que se puedan probar y sean comparables en todas las versiones.

  • Inmutabilidad de la versión: cada versión de un agente es inmutable después de guardarla. Las modificaciones en una versión existente requieren guardar y crear una nueva versión. Este requisito ayuda a garantizar la integridad de la versión y evita sobrescrituras accidentales.

  • Administración del estado de borrador: puede probar agentes en un estado no guardado con fines de experimentación. Si deja el portal de Foundry, pierde los cambios no guardados, por lo que debe guardar con frecuencia para conservar modificaciones importantes.

  • Operaciones de control de versiones: puede dirigir las solicitudes a versiones específicas del agente para habilitar las funcionalidades controladas de implementación y reversión.

  • Navegación del historial de versiones: acceda al historial de versiones de cualquier agente, vaya a cualquier versión específica y realice las siguientes comparaciones:

    Tipo de comparación Description
    Instalación del agente Comparación de las opciones de configuración entre versiones mediante la lista desplegable de versiones
    Salida del chat Análisis de las diferencias de respuesta entre las versiones del agente mediante entradas idénticas
    Definición de YAML Revisión de las diferencias en las definiciones del agente

Agregar herramientas

Haga que el agente sea más eficaz, ya que le proporciona conocimientos (archivos o índices específicos) o permite realizar acciones (llamando a API externas). Las herramientas están disponibles para la mayoría de los casos de uso, desde cargas de archivos simples a conexiones de servidor del Protocolo de contexto de modelo (MCP) personalizadas. Para herramientas más complicadas, es posible que tenga que configurar la autenticación o agregar conexiones como parte de su vinculación a un agente.

Para guardar un agente con una herramienta asociada, debe configurar correctamente la herramienta. Reutilización de herramientas configuradas entre agentes. Para obtener información sobre las herramientas disponibles, consulte el catálogo de herramientas.

Depuración y validación mediante el seguimiento (versión preliminar)

A medida que agrega herramientas e itera en las solicitudes, use el seguimiento para validar el comportamiento integral.

  • Confirme si el agente invocó las herramientas que esperaba.
  • Inspeccione las entradas y salidas de la herramienta.
  • Identifique las fuentes de latencia en las llamadas de modelo y herramienta.

Para obtener más información, consulte Información general sobre el seguimiento del agente.

Evaluación de la calidad y la seguridad (versión preliminar)

Antes de publicar el agente (y después de cualquier cambio significativo), ejecute evaluaciones para capturar regresiones y medir la calidad de forma coherente entre versiones.

Supervisión después de la publicación

Después de publicar una aplicación de agente, trátala como si fuera software de producción:

  • Supervisar señales de calidad y seguridad.
  • Revise los seguimientos cuando cambie el comportamiento.
  • Actualice y vuelva a publicar cuando corrija problemas o realice mejoras.

Para obtener instrucciones, consulte Supervisar la calidad y la seguridad.

Planificación de la identidad y los permisos

Las herramientas y los recursos de bajada suelen requerir autenticación. Al publicar un agente, su identidad y modelo de permisos puede cambiar. Asegúrese de que su agente publicado solo tenga el acceso que necesita.

Para obtener más información, consulte Conceptos de identidad del agente en Microsoft Foundry.

Seguridad y acceso

Trate la configuración del agente como el código de la aplicación. Proteger secretos y permisos durante todo el ciclo de vida:

Publica tu agente o flujo de trabajo

Después de crear un agente o una versión de flujo de trabajo con la que esté satisfecho, publíquelo como una aplicación de agente. Obtiene un punto de conexión estable que puede abrir y probar en el explorador, compartir con otros usuarios o insertar en las aplicaciones existentes. Usted y sus colaboradores pueden validar el rendimiento e identificar qué necesita refinamiento. Realice las actualizaciones necesarias y vuelva a publicar una nueva versión en cualquier momento.

Importante

Los permisos asignados a la identidad del proyecto no se transfieren automáticamente al agente publicado. Después de la publicación, vuelva a asignar los privilegios necesarios a la identidad de la aplicación del agente.

Problemas comunes de desarrollo de agentes

  • Los cambios no guardados son temporales: si desea comparar versiones, ver el historial o ejecutar evaluaciones completas, guarde los cambios como una versión.
  • Las herramientas deben configurarse antes de guardar: si una herramienta requiere autenticación o conexión, complete la configuración antes de guardarla.
  • La publicación puede requerir actualizaciones de permisos: después de la publicación, vuelva a comprobar el acceso a los recursos para la identidad del agente publicado y quite cualquier acceso que el agente ya no necesite.

Contenido relacionado

Más información sobre los tipos de agente:

Configure y extienda agentes:

Publicar y supervisar agentes:

Depurar y evaluar:

  • Last updated on