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. Puede usar el modo de desarrollador en Copilot Studio para probar el agente y comprobar si el orquestador de Copilot selecciona los orígenes de conocimiento para usarlos en respuesta a las solicitudes dadas.
Uso del modo de desarrollador en Copilot
Para habilitar el modo de desarrollador en Copilot, escriba -developer on. 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 específicamente dentro de su conocimiento empresarial (datos), funcionalidades o aptitudes (acciones o complementos) dentro del agente para responder a un aviso. La tarjeta de información de depuración incluye los siguientes campos:
- Metadatos del agente: identificadores del agente y la conversación.
- Funcionalidades: una lista de funcionalidades configuradas para el agente.
-
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
-
Ejecución: lista de funcionalidades y acciones ejecutadas para el símbolo del sistema
- Funcionalidades ejecutadas: estadísticas de estado y respuesta para las funcionalidades ejecutadas.
- Acciones ejecutadas: estado de ejecución de solicitud y respuesta para las acciones.
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:
- 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.
- Id . de conversación: identifica la sesión de chat activa o la conversación.
- Id . de solicitud: identifica el 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.
Importante
Si la sección Funcionalidades del agente indica que WebSearch está habilitado, esto solo significa que el agente ha habilitado la funcionalidad. No refleja la configuración de directiva en la Allow web search in Copilot nube que los administradores pueden usar para deshabilitar la búsqueda web de su organización. Para obtener más información, vea Administrar escenarios de Microsoft 365 Copilot en el Centro de administración de Microsoft 365.
Acciones del agente
Las acciones del agente muestran el identificador de acción y el número de versión, las funciones configuradas para la acción, junto con su estado de coincidencia y selección.
Tarjeta sin acciones habilitadas
Si no se ha habilitado ninguna acción, la sección de acciones indica que no hay ninguna acción habilitada.
Tarjeta sin funciones coincidentes
Si no se devolvió ninguna función coincidente para el símbolo del sistema determinado, esto probablemente indica que el símbolo del sistema no mencionó explícitamente el nombre de la acción.
Detalles de la ejecución
Las secciones de detalles ejecutadas muestran si se ejecutaron las funcionalidades o acciones configuradas para el símbolo del sistema y los detalles y el estado de la ejecución.
Detalles de la ejecución de la funcionalidad
Los detalles de la ejecución de la funcionalidad muestran la funcionalidad ejecutada y su estado. Cada funcionalidad puede tener detalles de ejecución diferentes, como el texto de búsqueda usado, la respuesta de la funcionalidad o el número de resultados devueltos.
Detalles de la ejecución de acciones
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.
Tarjeta sin funciones seleccionadas 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 esto se deba a 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, esto puede ser una indicación de limitación.
Tarjeta con detalles de ejecución sin función vacíos o con errores
En el caso de los complementos de extensión que no son de mensaje, si se produce un error o no hay detalles de ejecución de 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.
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 tarjeta de depuración
Si el orquestador no requiere sus datos o aptitudes de Microsoft 365 para responder a un mensaje, no se devuelve ninguna tarjeta de información de depuración.
Las tarjetas de depuración tampoco se devuelven en casos de limitación de capacidad, donde normalmente verá un mensaje de error para volver a intentarlo más tarde.
Notificación de un problema
Informe de cualquier comentario o problema con el agente mediante el botón de pulgar hacia arriba o hacia abajo. Incluya la etiqueta #extensibility en el informe.
Escriba un mensaje, incluida la etiqueta #extensibility, en el cuadro de texto.
