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 indicaciones dadas.
Usar el 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, se devuelve una tarjeta con información de depuración cada vez que el orquestador busca específicamente dentro de su conocimiento empresarial (datos), capacidades o habilidades (acciones o complementos) dentro de su agente para responder a una indicación. La tarjeta de información de depuración incluye los siguientes campos:
- Metadatos del agente: identificadores para el agente y la conversación.
- Funcionalidades: una lista de funcionalidades configuradas para el agente.
-
Acciones: una lista de acciones configuradas para el agente
- Funciones coincidentes: estado de las funciones coinciden en la búsqueda de índice de la aplicación en tiempo de ejecución
- Funciones seleccionadas para la ejecución: estado de las funciones seleccionadas para la invocación en función del razonamiento del orquestador
-
Ejecución: una lista de funcionalidades y acciones ejecutadas para el símbolo del sistema
- Funcionalidades ejecutadas: estadísticas de estado y respuesta para las capacidades ejecutadas.
- Acciones ejecutadas: estado de ejecución de solicitudes y respuestas para 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, entre los que se incluyen:
- Id. de agente: un identificador único para el agente, que incluye el id. de título y el id. de manifiesto.
- Versión del agente : el número de versión del agente que se está utilizando actualmente.
- Id. de conversación : identifica la conversación o la sesión de chat activa.
- Id. de solicitud : identifica la indicación específica dentro de la conversación.
Nota
El prefijo del ID de agente indica cómo se distribuye el agente:
-
U_Indica un agente de ámbito de usuario (instalación de prueba). -
T_Indica un agente de ámbito empresarial (publicado en el almacén de inquilinos o en el catálogo de la organización). -
P_indica un agente disponible públicamente.
Para obtener instrucciones de publicación relacionadas, consulte:
Funcionalidades del agente
La sección Capacidades del agente muestra las capacidades configuradas para el agente, definiendo el alcance de sus fuentes de conocimiento accesibles.
Importante
Si la sección Capacidades del agente indica que WebSearch está habilitado, esto solo significa que el agente ha habilitado la funcionalidad. No refleja la configuración de directiva de nube que los administradores pueden usar para deshabilitar la Allow web search in Copilot búsqueda web en su organización. Para obtener más información, consulte Administrar escenarios de Microsoft 365 Copilot en el Centro de administración de Microsoft 365.
Acciones de agente
Las acciones de agente muestran el ID 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 habilitó ninguna acción, la sección acciones indica que no hay ninguna acción habilitada.
Tarjeta sin funciones coincidentes
Si no se devolvió ninguna función coincidente para el mensaje especificado, esto probablemente indica que el mensaje no mencionó explícitamente el nombre de la acción.
Detalles de la ejecución
Las secciones de detalles ejecutados muestran si las funcionalidades o acciones configuradas se ejecutaron para el mensaje y cuáles de las cuales se ejecutaron para el mensaje y los detalles y el estado de la ejecución.
Detalles de ejecución de la funcionalidad
Los detalles de 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 utilizado, la respuesta de la funcionalidad o el número de resultados devueltos.
Detalles de ejecución de la acción
Los detalles de ejecución de la acción incluyen la función y su estado, junto con la latencia, la información de solicitud (punto de conexión de solicitud, método HTTP, encabezados de solicitud) y la respuesta.
Tarjeta sin ninguna función seleccionada para la ejecución
Si ninguna función de acción coincide con la intención de búsqueda del mensaje, la tarjeta de información de depuración notifica que no hay ninguna función seleccionada para la ejecución. Esto se debe probablemente a que la descripción del comando en el manifiesto no está relacionada semánticamente con la intención de búsqueda del mensaje especificado.
Si Copilot coincide previamente y ejecuta sus funciones correctamente, esto puede ser una indicación de limitación.
Tarjeta vacía o con error Sin detalles de ejecución de la función
Para complementos de extensión que no son de mensajería, si hay detalles de ejecución de funciones fallidos o no hay detalles, indica una falla durante el intento de su agente de asignar parámetros a la función seleccionada de su 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.
Para los complementos de extensión de mensajes, la mejor práctica es optimizar las respuestas en menos de nueve segundos. Para obtener más información, revisa 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 una API de complemento por parte de Copilot está establecido en 10 segundos.
Solucionar 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 que los datos o aptitudes de Microsoft 365 respondan a una indicación, no se devuelve ninguna tarjeta de información de depuración.
Tampoco se devuelven tarjetas de depuración en casos de limitación de capacidad, donde normalmente verás un mensaje de error en el que puedes volver a intentarlo más tarde.
Informar de un problema
Informe de cualquier comentario o problema con su agente mediante el botón de pulgar hacia arriba o hacia abajo. Incluye la etiqueta #extensibility en tu informe.
Escriba un mensaje, incluida la etiqueta #extensibility, en el cuadro de texto.