Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Las pruebas son una parte importante del proceso de desarrollo de agentes declarativos para Microsoft 365 Copilot Chat. Puede usar el modo de desarrollador al probar el agente para comprobar si el orquestador de Copilot selecciona los orígenes de conocimiento para usarlos en respuesta a las solicitudes dadas y cómo lo hace.
Además, puede usar la característica Versión preliminar de la aplicación (F5) en microsoft 365 Agents Toolkit para probar los agentes en un entorno de desarrollo local. Esta característica proporciona una manera interactiva de validar el comportamiento y solucionar problemas directamente desde la interfaz de desarrollo.
Uso del modo de desarrollador en Copilot Chat y Agents Toolkit
Puede probar el agente desde Agents Toolkit en Visual Studio Code seleccionando Vista previa de la aplicación (F5) en el panel Kit de herramientas de agentes. Esto inicia el agente en una experiencia de Copilot Chat basada en explorador, lo que le permite validar rápidamente cómo se comporta en respuesta a las solicitudes.
Una vez que seleccione el agente en Microsoft 365 Copilot Chat, escriba para habilitar el modo -developer onde desarrollador. Para deshabilitar el modo de desarrollador, escriba -developer off.
Mientras el modo de desarrollador está habilitado, una tarjeta con información de depuración devuelve cada vez que el orquestador busca en el agente conocimientos empresariales (datos), funcionalidades o aptitudes (acciones o complementos). En el kit de herramientas del agente, esta información de depuración aparece en el panel Depurar e incluye los campos siguientes:
- Metadatos del agente: identificadores para el agente y la conversación
- Funcionalidades: una lista de funcionalidades configuradas para el agente, junto con su estado de ejecución y estadísticas de respuesta (si se ejecutan)
-
Acciones: lista de acciones configuradas para el agente
- Funciones coincidentes: estado de las funciones coincidentes en la búsqueda del índice de la aplicación en tiempo de ejecución
- Funciones seleccionadas para la ejecución: estado de las funciones seleccionadas para invocación en función del razonamiento del orquestador
Sección de metadatos del agente
Los metadatos del agente proporcionan detalles clave sobre el agente y la sesión de depuración actual, incluidos:
- Resumen : información general de alto nivel de los orígenes de conocimiento configurados y sus estadísticas de uso
- Id. de agente : un identificador único para el agente, que incluye el identificador de título y el identificador de manifiesto.
- Versión del agente : el número de versión del agente actualmente en uso
- Identificador de conversación : identificador de la conversación o sesión de chat activa
- Id. de solicitud : identificador del símbolo del sistema específico dentro de la conversación
Funcionalidades del agente
En la sección Funcionalidades del agente se muestran las funcionalidades configuradas para el agente y se define el ámbito de sus orígenes de conocimiento accesibles. Se proporcionan los detalles siguientes para cada funcionalidad usada por el símbolo del sistema.
- Estado de ejecución : indica si se usó la funcionalidad durante la orquestación
- Archivo de registro de diagnóstico : un archivo de .txt descargable que contiene resultados de ejecución detallados, incluidos los mensajes de éxito o error, que pueden ayudar a solucionar problemas y validación.
Acciones del agente
La sección Acciones del agente proporciona información detallada sobre cómo se procesan las acciones del agente (funciones o complementos) durante la orquestación. Esta información se divide en tres áreas clave: metadatos de acción, coincidencia y selección de funciones, y detalles de ejecución.
Metadatos de acción
En esta sección se muestra información general sobre las acciones registradas para el agente. Esta información incluye el identificador de acción (el identificador único de la acción) y el número de versión (la versión de la definición de acción en uso).
Coincidencia y selección de funciones
En esta parte se muestra cómo el orquestador interpretó el mensaje del usuario y si alguna de las funciones se consideró relevante para la ejecución:
Funciones coincidentes : funciones que coinciden semánticamente con el símbolo del sistema del usuario durante la búsqueda del índice de aplicaciones en tiempo de ejecución. Si no se devolvió ninguna función coincidente para el símbolo del sistema determinado, es probable que el símbolo del sistema no mencionara explícitamente el nombre de la acción.
Funciones seleccionadas para la ejecución : funciones elegidas para la invocación en función del razonamiento y la relevancia del orquestador para la solicitud. Si no se ha habilitado ninguna acción, la sección de acciones indica que no hay ninguna acción habilitada.
Detalles de la ejecución
Los detalles de la ejecución de la acción incluyen la función y su estado, junto con la latencia, la información de la solicitud (punto de conexión de solicitud, método HTTP, encabezados de solicitud) y la respuesta.
Solución de problemas de errores
A continuación se muestran los errores comunes que puede encontrar al depurar el agente y las posibles causas de los errores.
Sin información de depuración
Después de iniciar el agente, compruebe que la conexión al explorador está marcada como correcta en el panel de depuración. Si no es así, intente ejecutar F5 de nuevo en Visual Studio Code para iniciar una nueva sesión.
Si la conexión se realiza correctamente, pero no ve información de depuración, puede deberse a que el orquestador no requiere que los datos o aptitudes de Microsoft 365 respondan. En este caso, no se devuelve ninguna tarjeta de información de depuración.
La información de depuración tampoco se devuelve en los casos de limitación de capacidad, donde normalmente verá un mensaje de error para volver a intentarlo más tarde.
Información de depuración con Ninguna función seleccionada para la ejecución
Si ninguna función de acción coincidía con la intención de búsqueda del símbolo del sistema, la tarjeta de información de depuración notifica No hay funciones seleccionadas para su ejecución. Es probable que la descripción del comando del manifiesto no esté semánticamente relacionada con la intención de búsqueda del símbolo del sistema determinado.
Si Copilot coincidió y ejecutó correctamente las funciones, es posible que las solicitudes estén limitadas.
Información de depuración con detalles de ejecución sin función vacíos o con errores
En el caso de los complementos de API, si se produce un error o no hay detalles de ejecución de la función, indica un error durante el intento del agente de asignar parámetros a la función seleccionada del complemento. Si el error es coherente, lo más probable es que se deba a descripciones de parámetros o acciones poco claras, direcciones URL de host no válidas u otros problemas con la definición de Open API.
En el caso de los complementos de extensión de mensaje, el procedimiento recomendado es optimizar las respuestas en menos de nueve segundos. Para obtener más información, revise los requisitos técnicos de los complementos de extensión de mensaje.
Actualmente, el límite de tiempo de espera para la ejecución de Copilot de una API de complemento se establece en 10 segundos.
Notificación de un problema
Informe de cualquier comentario o problema con el agente mediante el botón de dedo pulgar hacia arriba o hacia abajo. Incluya la etiqueta en el #extensibility informe.
