Probar juntos los componentes del complemento

Pruebe lo que contiene o hace referencia el paquete de complementos: aptitudes, conectores MCP remotos y, si incluye uno. Esta tarea de prueba de & de paquetes establece el comportamiento y la integración de los componentes antes de crear el artefacto de versión. A continuación se realizan las comprobaciones finales de validación, instalación y experiencia de lanzamiento del paquete en Probar y validar el complemento. Elija las pruebas para sus componentes, mantenga un registro de pruebas y luego complete Antes de empaquetar.

Elige tus pruebas

Verificar componentes en el escenario integrado

En el complemento Probar con Sección
Habilidades a nivel de complemento, con o sin agente Sesión de desarrollo de Cowork; compatible Selección de aptitudes de chat Probar habilidades
Conectores de complementos que apuntan a servidores MCP remotos Inspector, luego la misma tarea a través del complemento en Cowork Probar conectores MCP remotos
Agente declarativo, si está incluido Work IQ Herramientas de desarrollo Ask command y DevUI Probar un agente declarativo incluido
Dependencias usadas por la solución Diagnósticos del conector y, luego, repita la tarea integrada Probar dependencias

Saber qué conector está probando

  • Conector del complemento: Una entrada de manifiesto agentConnectors[] de aplicación. Este artículo prueba el tipo de MCP remoto: el paquete hace referencia a un servidor; No contiene el servicio en ejecución.
  • Conector de Copilot (sincronizado): Ingiere conocimiento en Microsoft Graph. Pruebe su ingesta y posterior recuperación como dependencias.
  • Conector de Copilot (federado): Recupera datos activos bajo la identidad conectada. Pruebe el acceso en directo por separado de la ingesta.
  • Conector de Power Platform: Una herramienta de Copilot Studio. Probarlo no establece que su agente sea un complemento del registro.

La referencia de creación de complementos también documenta una ruta explícita para las referencias de conectores personalizados de OpenAPI existentes. Utilice los requisitos de esa ruta si corresponde; el procedimiento MCP de este artículo no comprueba ese tipo de conector.

Cómo juzgar un resultado

Compruebe cada componente de forma independiente y, a continuación, ejecute una tarea que use los componentes juntos. Una llamada directa de servicio correcta establece el comportamiento del servidor. La tarea integrada establece la selección, la entrada, la autenticación y el uso de los datos devueltos.

Antes de realizar las pruebas, defina las comprobaciones necesarias y las pruebas aceptables para cada componente y experiencia objetivo. Incluya la selección de componentes, los resultados correctos y los límites de acceso. Use evidencia apropiada para la afirmación:

Componente o notificación Evidencia que se debe conservar
Selección de aptitudes y comportamiento Evidencia de host que identifica la aptitud seleccionada o cargada, además de los archivos y salidas necesarios. En el panel lateral de Cowork, Habilidades identifica habilidades cargadas. La selección explícita no establece una invocación automática.
Invocación remota de MCP Registros de servicio autenticados correlacionados con la solicitud del host, identificando la operación, las entradas y el resultado. Una llamada directa al inspector no establece la invocación a través del complemento.
Agente incluido Identidad del agente implementada, solicitud y respuesta, y diagnóstico disponible de selección, recuperación y citación de capacidades. Los diagnósticos del agente por sí solos no establecen la invocación de todas las habilidades o scripts incluidos.
Ejecución de scripts de aptitudes Diagnósticos de ejecución cuando se expone. Los archivos de salida necesarios establecen el resultado de salida, no una prueba de que se haya ejecutado un script determinado. Si la ejecución de ese script es un requisito de liberación, obtenga pruebas que lo establezcan.
  • Juzgue la corrección de la respuesta por separado de la evidencia de invocación. Un agente puede producir notas de versión plausibles sin cargar su habilidad.
  • La evidencia faltante para una verificación requerida permanece sin verificar y bloquea la preparación. No debilite una comprobación necesaria porque los diagnósticos no estén disponibles.
  • Cuando un host no expone detalles de diagnóstico adicionales, registre esa limitación sin reclamar que se comprobó el detalle. Los diagnósticos no disponibles no son un bloqueador separado cuando la evidencia ya satisface las comprobaciones requeridas.
  • Trate la reserva silenciosa o un resultado incompleto como un error.
  • Guarde las pruebas desinfectadas en un almacenamiento aprobado, nunca credenciales. Las instantáneas de agente pueden contener contenido confidencial.

Requisitos previos y datos de prueba conocidos

Use un proyecto de complemento existente, un inquilino de desarrollo, identidades de prueba conocidas y datos que no sean de producción. Seleccione los entornos y las experiencias de Microsoft que desea admitir. Autorice el inicio de sesión, el consentimiento, las conexiones y los servicios externos necesarios antes de realizar las pruebas.

Para los siguientes comandos, instale las herramientas de desarrollo de Work IQ: Node.js 24.15+ y npm son necesarios para su CLI, además de PowerShell 7+ en Windows.

Preparar:

  • Registro conocido: Problema 123 en un repositorio de prueba, con su título exacto, estado y dirección URL registrados del origen.
  • Entrada de habilidad:Added CSV export; Fixed duplicate rows; Updated help text. Para una aptitud de notas de la versión, espere características, correcciones y otros, respectivamente, además de cualquier archivo prometido o contenido producido por script.

Reemplace los nombres de ejemplo, los identificadores y los marcadores de posición. Iniciar sesión y comprobar la preparación antes de los comandos del inquilino:

wiqd auth login --interactive
wiqd doctor

Verificar: Las comprobaciones de inicio de sesión y preparación se realizan correctamente para el inquilino previsto.

Para obtener indicaciones del asistente opcional, instale la CLI de GitHub Copilot. Si su complemento de guía WIQD aún no está instalado, ejecute estos comandos y, a continuación, inicie una nueva sesión en el proyecto de complemento existente:

copilot plugin install wiqd@awesome-copilot
copilot plugin list --json
copilot

Verificar: El inventario muestra la guía WIQD instalada y habilitada. Las instalaciones existentes deben seguir la guía de instalación en lugar de agregar duplicados. Este complemento de guía no instala la CLI de WIQD. Pegue las solicitudes del asistente en la sesión del asistente de codificación; las solicitudes de agente implementado usan en su lugar la opción Probar un -qagente declarativo incluido.

Probar habilidades

Componente del complemento: Aptitudes de nivel de complemento registradas a través de app-manifest agentSkills.

Lo que esto demuestra: La habilidad prevista carga y produce el resultado esperado en una implementación de desarrollo.

Aún por probar después del empaque: El artefacto exacto se valida, se instala a través de la ruta de distribución y se ejecuta en todas las experiencias reclamadas.

Evidencia para conservar: Implementación/versión, aptitud cargada, archivos de entrada y salida, y registros de llamadas remotas disponibles.

Usa Copilot Cowork para la implementación de desarrollo. Reutilice su enlace de instalación o prueba impreso real cuando esté disponible.

  1. Si es necesario aprovisionamiento, inspeccione m365agents.yml y el archivo de entorno seleccionado en su configurado environmentFolderPath primero. Confirme el inquilino y eficaz AGENT_SCOPE; los andamios estándar se usan local para el ámbito personal y dev para el ámbito compartido, pero los nombres por sí solos no son una prueba. Apruebe los cambios propuestos y, a continuación, ejecute:

    wiqd plugin provision --env "<test-environment>"
    

    Verificar: El aprovisionamiento se realiza correctamente y devuelve el vínculo de instalación o prueba de la implementación.

  2. Abra el vínculo devuelto y complete la instalación y las conexiones requeridas con la identidad de prueba. Inicie una sesión de Cowork y solicite notas de la versión utilizando la entrada conocida.

    Verificar: Su habilidad aparece en Habilidades en el panel lateral de la sesión.

  3. Inspeccione la respuesta y cualquier archivo en la carpeta>Salida, Vista previa o Descarga.

    Verificar: Todos los cambios aparecen en las categorías previstas y los archivos prometidos cumplen los requisitos.

  4. Ejecute las pruebas de descubrimiento e invocación en cada experiencia compatible, utilizando esta implementación y la entrada conocida.

    Verificar: El comportamiento de detección, selección y error cumple los requisitos de la aptitud para esa experiencia.

Una habilidad cargada personalmente prueba un registro diferente al del complemento agentSkills; en su lugar, las habilidades adjuntas al agente se usan agent_skills en el manifiesto del agente declarativo. Las evidencias de aptitudes cargadas no establecen la ejecución por script.

En el ciclo de vida documentado, el aprovisionamiento crea o actualiza la implementación de inquilinos en su ámbito seleccionado y escribe enlaces de entorno. La reutilización de una identidad de recursos existente puede afectar a los usuarios actuales; Autorizar dichos cambios. El aprovisionamiento no ejecuta los comandos de publicación o uso compartido independientes. El vínculo de instalación no es una prueba de la publicación del registro, la disponibilidad del público o la instalación de su archivo zip final. Continuar por separado a través de Publicar & distribuir y Hacer disponible & rigen, incluida la aprobación, instalación, consentimiento y conexiones aplicables.

¿Prefiere usar la CLI de GitHub Copilot?

Help test <skill-name> in this plugin's existing Cowork development deployment.
Reuse its printed install link. Ask before provisioning; inspect the actual
environment scope first. Don't publish or share. Request release notes for
"Added CSV export; Fixed duplicate rows; Updated help text." Compare categories
and promised files; test missing input. Guide explicit/automatic Chat selection
if supported. Let me operate inaccessible UI and handle sign-in/consent.
Show actual evidence and ask before installs, exposure, or external changes.

Probar conectores MCP remotos

Componente del complemento:agentConnectors[] entradas que apuntan a servicios MCP remotos.

Lo que esto demuestra: el comportamiento del servidor de forma independiente y, a continuación, el uso autenticado mediante el complemento de desarrollo.

Aún por probar después del empaque: Las declaraciones de conector, la configuración de conexión y las llamadas en tiempo de ejecución funcionan a partir del artefacto instalado exacto.

Evidencia para conservar: Punto final/versión, esquema de herramienta, entradas/resultados, identidad y registros de host/servidor correlacionados.

Use MCP Inspector con Node.js 22.19.0+, el punto de conexión HTTP Streamable de confianza, sus detalles de autenticación y una operación segura de solo lectura.

  1. Inicie el Inspector, sustituyendo la URL de ejemplo:

    $serverUrl = 'https://your-server.example/mcp'
    npx @modelcontextprotocol/inspector --server-url "$serverUrl" --transport http
    

    Verificar: La autenticación finaliza y aparecen la identidad y las funcionalidades esperadas del servidor.

  2. Herramientas de lista, seleccione la operación de búsqueda, escriba los campos definidos por esquema para el registro conocido y ejecútela.

    Verificar: El esquema y el título, el estado y la dirección URL devueltos coinciden con las expectativas.

  3. Repita con un registro inexistente y una identidad restringida.

    Verificar: El comportamiento de registro que falta es accionable y el contenido no autorizado permanece inaccesible.

  4. Abra el enlace de instalación y prueba de Cowork del complemento de desarrollo, utilizando el paso de aprovisionamiento en Probar habilidades si es necesario; los proyectos solo de conector no requieren una habilidad. Complete la configuración de la conexión y solicite el mismo registro. Si una aptitud debe usar el conector, inólelo con esa solicitud.

    Verificar: Los registros de servicio autenticados muestran la operación y las entradas esperadas, y los valores devueltos coinciden con el resultado de la sesión.

  5. Pruebe cualquier operación de escritura aprobada solo contra registros desechables, incluida la cancelación.

    Verificar: Los cambios aprobados coinciden con la solicitud y la cancelación deja los datos de origen sin cambios.

Compare el punto de conexión y la referencia de autenticación en la configuración del componente con lo que realmente se ejecutó. Seguir los requisitos del conector, incluidos los requisitos aplicables de descripción de la herramienta; El éxito del servidor por sí solo no establece la preparación de la conexión del host.

Para un servicio local, inícielo con el comando de su proyecto. Después de aprobar la exposición, siga Crear un túnel de desarrollo persistente. Para este conector de complemento, establezca remoteMcpServer.mcpServerUrl el punto de conexión HTTPS público con su ruta de MCP real; actualice su implementación de desarrollo a través del flujo de trabajo del proyecto y vuelva a probar. Conserve la autenticación de la aplicación y detenga el túnel cuando se complete la prueba.

Verificar: Los registros de servicio muestran la solicitud de host autenticada en el punto de conexión previsto.

¿Prefiere usar la CLI de GitHub Copilot?

Help test this plugin's remote MCP connector at <endpoint>. Show the Inspector
command and ask before downloads or launch. Let me authenticate and call
<read-only-tool/input>; compare with <expected-record>. Then guide the same
task in the existing Cowork deployment and correlate sanitized server logs.
Ask before exposure, deployment, or writes; report diagnostics you can't see.

Probar un agente declarativo incluido

Componente del complemento: Un agente declarativo opcional compuesto en el proyecto de complemento.

Lo que esto demuestra: Respuestas de agentes y diagnósticos disponibles de complementos seleccionados, recuperación y citas.

Aún por probar después del empaque: Las referencias del agente empaquetado y el escenario completo del complemento instalado funcionan en experiencias reclamadas.

Evidencia para conservar: Agente/versión, id. de solicitud/conversación, funcionalidad seleccionada, entrada y salida real.

Siga la anatomía del proyecto del complemento compatible. Use las herramientas de desarrollo de Work IQ y DevUI en el agente ya implementado correspondiente a ese componente.

  1. Enumerar agentes y ejecutar la búsqueda:

    wiqd agent list
    wiqd plugin ask --component agent --agent-id "<agent-id>" -q "Find issue 123 in my test repository. Return its title, status, and source URL."
    

    Verificar: El agente seleccionado y los valores devueltos coinciden con el componente y el registro de origen.

  2. Habilite la marca de vista previa de DevUI documentada y repita:

    wiqd config flags set devui true
    wiqd devui start --agent "<agent-name>"
    wiqd devui ask --agent "<agent-name>" -q "Find issue 123 in my test repository. Return its title, status, and source URL."
    

    Inspecciona los complementos seleccionados, la recuperación, las citas y los resultados sin procesar.

    Verificar: Los diagnósticos disponibles identifican la funcionalidad prevista y los datos devueltos esperados.

  3. Si el agente tiene una aptitud asociada, compruebe su resultado:

    wiqd devui ask --agent "<agent-name>" -q "Draft release notes from these changes: Added CSV export; Fixed duplicate rows; Updated help text."
    

    Verificar: Los cambios y los archivos prometidos satisfacen los requisitos de la aptitud.

  4. Detenga el servidor de diagnóstico:

    wiqd devui stop
    

    Verificar: El comando informa de que se ha detenido o no se ha ejecutado.

Los diagnósticos publicados de DevUI no establecen la invocación por aptitud o por script. Registre la corrección de salida por separado. Pruebe también las instrucciones específicas del agente, las indicaciones sugeridas y las solicitudes fuera de ámbito en función de su comportamiento definido.

¿Prefiere usar la CLI de GitHub Copilot?

Use WIQD to list agents; let me choose the component's deployed <agent-id>.
Ask it for issue 123 in <repository>, comparing with <expected-title/status/URL>.
Open DevUI and repeat; help inspect selected plugins, retrieval, citations,
raw results, and request IDs. If <skill-name> is attached, request release
notes for "Added CSV export; Fixed duplicate rows; Updated help text."
Compare outputs separately from invocation evidence. Show commands/results
and stop DevUI. Ask before configuration, deployment, sharing, or external
writes. Let me handle sign-in and inaccessible UI; don't publish anything.

Consulte el flujo de trabajo agente de DevUI documentado.

Probar dependencias

Pruebe los servicios y el conocimiento en los que confían sus componentes y, a continuación, repita la tarea del complemento integrado. Estas comprobaciones de dependencia no son registros adicionales de componentes de complemento.

Conector de Copilot sincronizado

Dependencia: Conocimiento indexado utilizado por el agente incluido.

Lo que esto demuestra: Ingesta, actualización, permisos y posterior recuperación.

Aún por probar después del empaque: El complemento instalado utiliza la conexión y los registros previstos.

Evidencia para conservar: Id. de conexión, salida de rastreo, recuento indexado, citas y valores de origen.

Para la plantilla Problemas de GitHub, siga Compilación del primer conector sincronizado para conocer los requisitos previos, la configuración del repositorio, el consentimiento, el rastreo y las comprobaciones de indexación. Para otras implementaciones, use sus procedimientos de rastreo y diagnóstico documentados.

  1. Confirme que el identificador de conexión configurado para el agente incluido coincide con la conexión probada y que el registro conocido está indexado.

    Verificar: Los diagnósticos de conexión identifican el origen previsto y los elementos indexados esperados.

  2. Consulte al agente configurado con esa conexión, actualice un problema descartable, vuelva a ejecutar el conector y vuelva a consultar. Pruebe la eliminación a través de su ruta de conciliación y acceso restringido donde se aplican permisos de elemento.

    Verificar: Los valores, las citas, las actualizaciones, el control de eliminaciones y los requisitos de coincidencia de acceso.

Conector de Copilot federado

Dependencia: Una conexión federada disponible usada en el escenario admitido.

Lo que esto demuestra: Recuperación en directo bajo la identidad conectada.

Aún por probar después del empaque: El escenario completo del complemento instalado usa la ruta de acceso a datos prevista.

Evidencia para conservar: Identidad, registro de origen, respuesta/citas y registros de servicio disponibles.

  1. En Copilot Chat, selecciona ...>Configuración>Orígenes, busque el origen, seleccione Conectar y autentique.

    Verificar: La conexión se realiza correctamente para la identidad prevista.

  2. Solicite el registro conocido por nombre de origen o ID. Actualice un registro desechable y repita. Además, pruebe una identidad restringida.

    Verificar: Aparecen cambios en directo y los permisos de origen siguen siendo obligatorios.

Probar escenarios de usuario completos

Ejecute la misma tarea conocida a través de la experiencia prevista con todos los componentes necesarios habilitados. Por ejemplo, pida a una habilidad que recupere el problema conocido y produzca notas de la versión solo si ese flujo de trabajo combinado forma parte de la solución.

  1. Inicie una nueva conversación con la identidad de prueba prevista y la entrada.

    Verificar: La aptitud o el agente esperados controlan la solicitud.

  2. Reúna la evidencia específica del componente. En el caso de las llamadas remotas, correlacione los diagnósticos del host disponibles con los registros de servicio autenticados.

    Verificar: Se selecciona el componente deseado. Cuando se requiere una herramienta, recibe la entrada y la identidad correctas, y se utiliza su salida real.

  3. Compare la respuesta y los archivos con el resultado esperado.

    Verificar: El contenido, las citas y los resultados prometidos cumplen con los requisitos.

Errores y límites de prueba

Repita con entradas faltantes o ambiguas, autenticación expirada, consentimiento denegado, datos restringidos, dependencias no disponibles, resultados vacíos o mal formados, errores de script, tiempos de espera, limitaciones y reintentos. Confirme el comportamiento de error seguro y procesable, así como las confirmaciones necesarias. Registre cada resultado esperado antes de ejecutar la prueba.

Registrar resultados de integración

Use un registro por escenario e identidad. Llévelo a las pruebas de paquetes; Rellene los campos del paquete después del embalaje.

Campo Mantener
Components Versiones, archivos, puntos de conexión, referencias de conexión y revisión de código fuente
Paquete Identidad, versión, ruta de acceso ZIP y hash SHA256 opcional; Pendiente antes del empaquetado
Contexto Entorno, experiencia/estado de lanzamiento, marcas de características, rol de identidad de prueba y fecha
Escenario Comprobaciones requeridas, evidencia aceptable, entrada repetible y resultado esperado frente a real
Evidencia Registros de invocación saneados, identificadores de solicitud, salidas y ubicaciones de informes
Decisión Aprobado, no aprobado o sin comprobar; Brechas de evidencia requeridas, limitaciones de diagnóstico, propietario y próxima acción

Antes de empaquetar

  • Invocación: Confirme la selección de capacidad prevista y las entradas/salidas esperadas.
  • Acceso: Complete las comprobaciones de acceso autorizado o restringido, consentimiento y confirmación.
  • Resultados y fracasos: Complete las pruebas de error aplicables.
  • Experiencias previstas: Registre los resultados de desarrollo por separado para cada experiencia de versión compatible; Planear las comprobaciones finales de los artefactos instalados.
  • Registro de entrega: Guarde los registros de prueba y resuelva los bloqueadores de implementación antes del empaque.
  • Referencias de paquetes: Confirme que las versiones de los componentes, los archivos, los identificadores, las referencias de conexión y los puntos finales probados son a los que hará referencia el paquete.

Siguiente paso

Continuar paquete & prueba: Cree el paquete de complementos y, a continuación, valide y pruebe el paquete utilizando el mismo registro de evidencia y las referencias empaquetadas exactas.