Configuración y administración de agentes en Visual Studio Code

Una vez que tenga un agente declarativo (creado en el portal de Foundry o a través del SDK), comienza el trabajo real, configurando su comportamiento, instrucciones y propiedades para que coincidan con sus requisitos. La extensión de VS Code de Microsoft Foundry proporciona opciones de configuración completas a través del Diseñador de agentes visuales y la edición directa de archivos YAML, lo que proporciona flexibilidad en el funcionamiento.

Configuración de las propiedades del agente

El Diseñador de agentes proporciona una interfaz intuitiva para configurar las propiedades principales del agente. Esto ajustes definen los aspectos fundamentales de cómo responde y opera el agente.

Opciones de configuración esenciales

En el Diseñador de agentes, configurará varias propiedades clave:

Nombre del agente : escriba un nombre descriptivo que identifique claramente el propósito del agente. Este nombre aparece en listas, registros y cuando otros desarrolladores trabajan con los agentes.

Selección de modelo - elija la implementación del modelo de la lista desplegable. Esta selección determina qué modelo de IA impulsa las respuestas del agente. La lista desplegable muestra solo los modelos que ya ha implementado en el proyecto.

Descripción : agregue una descripción clara y concisa de lo que hace el agente. Las buenas descripciones ayudan a los miembros del equipo a comprender el propósito del agente sin leer sus instrucciones ni código.

Instrucciones del sistema : defina el comportamiento, la personalidad y el estilo de respuesta del agente. Aquí es donde se forma la forma en que el agente entiende su rol e interactúa con los usuarios.

Id. de agente : generado automáticamente por la extensión al crear el agente. Este identificador único se usa al llamar al agente a través de las API.

Opciones de configuración del modelo

Más allá de seleccionar un modelo, puede ajustar su comportamiento a través de parámetros adicionales:

Temperatura : controla la creatividad y la aleatoriedad de la respuesta. Los valores inferiores (0.1-0.3) producen salidas coherentes y centradas. Los valores más altos (0,7-1,0) generan respuestas más creativas y variadas. En el caso de los agentes empresariales que controlan tareas estructuradas, los valores entre 0.3 y 0.7 suelen funcionar bien.

P superior : controla la diversidad limitando las opciones de vocabulario durante la generación. La mayoría de los escenarios funcionan bien con el valor predeterminado de 1.0, pero puede reducirlo para salidas más restringidas y predecibles.

Estos valores aparecen tanto en la interfaz del diseñador como en el archivo YAML, que permanecen sincronizados entre ambas vistas.

Comprensión de la estructura YAML del agente

El archivo YAML contiene toda la configuración del agente declarativo en un formato estructurado y legible. Comprender esta estructura le ayuda a realizar cambios precisos y trabajar de forma eficaz cuando la interfaz visual no es la mejor opción.

Ejemplo completo de YAML

Este es un archivo YAML del agente totalmente configurado:

# yaml-language-server: $schema=https://aka.ms/ai-foundry-vsc/agent/1.0.0
version: 1.0.0
name: healthcare-assistant
description: Assists healthcare staff with patient appointment scheduling and information retrieval
id: 'agent-abc123xyz'
metadata:
  authors:
    - developer-name
  tags:
    - healthcare
    - customer-service
    - scheduling
model:
  id: 'gpt-4.1'
  options:
    temperature: 0.5
    top_p: 1
instructions: |
  You're a healthcare assistant helping staff schedule patient appointments and retrieve information.
  
  Your responsibilities:
  - Help staff find available appointment slots
  - Answer questions about patient scheduling policies
  - Provide information about different appointment types
  - Assist with rescheduling and cancellations
  
  Important guidelines:
  - Never access or share patient medical information
  - Always verify appointment details before confirming
  - Be professional but friendly in all interactions
  - If you're unsure about policies, advise staff to check with management
tools: []

La estructura YAML se divide de forma natural en secciones: metadatos, configuración del modelo, instrucciones y herramientas. Esta organización facilita la localización y modificación de una configuración específica.

Ventajas de la configuración de YAML

La edición directa de YAML proporciona varias ventajas:

• Control de versiones : seguimiento de los cambios en Git junto con el código de la aplicación
• Actualizaciones masivas : realizar varios cambios simultáneamente con confianza
• Plantillas : creación de plantillas de agente reutilizables para configuraciones coherentes
• Revisión de código: incluir configuraciones del agente en los procesos de revisión de código estándar
• Automation : compilación de scripts que generan o modifican configuraciones de agente mediante programación

La extensión valida la sintaxis de YAML en tiempo real, resaltando errores y proporcionando sugerencias a medida que escribe.

Procedimientos recomendados para la configuración del agente

A medida que se crean agentes más complejos, estas prácticas ayudan a mantener la calidad y la confiabilidad:

Control de versiones de los archivos YAML : confirme las configuraciones del agente en Git junto con el código de la aplicación. Esto permite la reversión, la revisión de código y el seguimiento de cambios.

Usar nombres descriptivos y etiquetas : la nomenclatura y el etiquetado claros facilitan la búsqueda e identificación de agentes a medida que crece la colección.

Instrucciones complejas del documento : incluya comentarios en los archivos YAML que explican por qué ha elegido configuraciones o patrones de instrucción específicos.

Prueba después de cada cambio : use el área de juegos integrada para comprobar el comportamiento después de modificar la configuración. Los pequeños cambios pueden tener efectos inesperados.

Comience simple y, a continuación, iteración : comience con instrucciones básicas y agregue complejidad en función de los resultados de las pruebas. Las instrucciones iniciales demasiado complejas son más difíciles de depurar.

Mantener las instrucciones centradas : cada agente debe tener un propósito claro y específico. Los agentes que intentan hacer demasiadas cosas funcionan incoherentemente.

La configuración de agentes en Visual Studio Code proporciona funcionalidades eficaces para crear una automatización sofisticada. La combinación de herramientas de diseño visual y edición directa de YAML permite un desarrollo rápido y mantiene la precisión necesaria para las implementaciones de producción.