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.
Durante la preparación, convierta sus opciones de capacidad en un plan de compilación. Comience con Herramientas de desarrollo de Work IQ para el desarrollo profesional, elija un entorno documentado y agregue Microsoft 365 Agents Toolkit o un SDK solo cuando el escenario lo necesite. Finaliza con una herramienta, ubicación de origen, propietario y requisitos previos para cada componente.
Para compilar las funcionalidades de Copilot en una aplicación de su propiedad, siga en su lugar Crear aplicaciones con tecnología de Copilot .
Empezar con Herramientas de desarrollo de Work IQ
Work IQ Dev Tools es la ruta de desarrollo profesional predeterminada para escenarios de complementos compatibles. Usa su flujo de trabajo guiado para crear y redactar un complemento y, a continuación, validarlo, aprovisionarlo, empaquetarlo y compartirlo. Utilice comandos directos de CLI cuando necesite una ejecución o secuencias de comandos repetibles.
Elija la superficie de comandos propiedad del origen:
| El origen y la tarea | Empieza aquí | Límite |
|---|---|---|
| Un nuevo complemento que contenga aptitudes compatibles, conectores de complementos para servidores MCP remotos o un agente declarativo opcional | Compilar un complemento con WIQD |
wiqd plugin add agent andamios un componente del agente; No importa un proyecto de agente existente. |
| Un proyecto de origen de agente declarativo existente | Ciclo de vida de los componentes del agente | Use el flujo de trabajo documentado wiqd agent para ese proyecto. |
| Un complemento abierto, complemento de Claude o complemento de cursor compatible. | Importación y exportación de WIQD | La conversión de formato no establece un comportamiento en tiempo de ejecución equivalente o compatibilidad con hosts. |
| Una implementación compartida probada para los usuarios seleccionados | Compilar un complemento con WIQD | Compartir otorga acceso; no es el envío del catálogo de la organización. |
| Un complemento probado para el catálogo de la organización | Publicación y proyectos existentes |
wiqd plugin publish Se envía para la aprobación del administrador, no para la certificación pública de Marketplace. |
Usar la validación de origen explícita para las comprobaciones sin conexión. El modo de validación predeterminado es la validación de paquetes en un archivo ZIP existente; Puede cargar el paquete y requerir autenticación. Ninguno de los modos reemplaza la prueba de las capacidades reales en la experiencia prevista.
Elija su entorno
En la tabla siguiente se enumeran las rutas WIQD documentadas. No es una matriz de compatibilidad exhaustiva:
| Entorno | Úselo para | Configuración y restricciones |
|---|---|---|
| CLI de GitHub Copilot | Creación guiada de complementos con el complemento WIQD de codificación-asistente | Instale el host y su complemento de mercado WIQD y, a continuación, inicie una nueva sesión. El complemento de Marketplace no instala la CLI de WIQD. |
| Código Claude | Creación guiada con el complemento WIQD para ese host | Siga los pasos de Marketplace específicos del host en la instalación de WIQD. |
| Línea de comandos directa | Validación y comandos repetibles del ciclo de vida del complemento o agente | Instale la CLI independiente. La ruta del script de instalación requiere Node.js 24.15 o posterior y npm; Windows requiere PowerShell 7 o posterior. |
| Visual Studio Code | Edición de proyectos y diagnóstico de manifiestos a través de la extensión opcional de WIQD | Siga la instalación de WIQD para la integración actual del editor. Los diagnósticos del Editor no reemplazan la validación del paquete final. |
| Canalizaciones de CI/CD de confianza | Operaciones de aprovisionamiento, publicación y uso compartido respaldadas por núcleos, sujetas a los límites de autenticación de la versión seleccionada | Siga las instrucciones de CI/CD del complemento y la autenticación de canalizaciones. Los ejemplos de canalización de agente-proyecto no son un generador de canalizaciones compatible con complementos. |
Para las operaciones de inquilinos locales, inicie sesión de forma interactiva antes del aprovisionamiento. Para la automatización, utilice el contrato de canalización de confianza publicado y el almacenamiento secreto. No ejecute Interactive wiqd auth login en CI ni exponga credenciales a trabajos de solicitud de incorporación de cambios que no sean de confianza. La autenticación del ciclo de vida principal no autentica las consultas, evaluaciones u otras extensiones de Work IQ. No aplique un cuerpo de comandos agent-project sin cambios a un proyecto de complemento.
Para los requisitos previos de la cuenta, el inquilino y la herramienta, use Configuración del entorno de desarrollo. Un asistente de codificación puede ayudar a crear archivos, pero no reemplaza la herramienta de creación, el tiempo de ejecución, los permisos o los requisitos de publicación del componente.
Agregar herramientas específicas de componentes cuando sea necesario
Utilice estas rutas de producto cuando el componente seleccionado necesite controles específicos de creación o de proyecto. Sigue el propio procedimiento del producto en lugar de tratar las herramientas como formatos de paquete intercambiables.
| Requisito | Entrega de herramientas o productos |
|---|---|
| Control de nivel inferior de un proyecto, manifiestos o integraciones de agente declarativo compatibles | Kit de herramientas de agentes de Microsoft 365, con JSON o TypeSpec |
| Una experiencia de creación de agentes declarativos administrados y guiados | Creador de agentes; Usar su propio procedimiento de aptitudes para las aptitudes admitidas |
| Flujos de trabajo administrados, conectores de Power Platform, entornos y lógica de agente con poco código | Copilot Studio; usa su canal de publicación de Microsoft 365 cuando corresponda |
| Un agente basado en sitios de SharePoint o bibliotecas de documentos seleccionados | Instrucciones para agentes de SharePoint y instrucciones de actualización para el formato seleccionado |
| Conectores de aptitudes o complementos para Copilot Cowork | Compilar complementos para Copilot Cowork para los requisitos de prueba, tiempo de ejecución y archivos específicos del producto |
| Un conector de Copilot (sincronizado) que ingiere contenido externo en Microsoft Graph | Cree su primer conector de Copilot personalizado |
| Una acción MCP remota en un agente declarativo | Compilar un complemento desde un servidor MCP |
Agent Builder en Copilot Studio no admite actualmente la adición de aptitudes. No deduzca su conjunto de funcionalidades a partir de la experiencia independiente de Agent Builder en Microsoft 365 Copilot. Los agentes independientes de Copilot Studio aparecen en el Registro de agentes, no en complementos.
Para proyectos de Cowork importados, consulta las limitaciones actuales en la guía de desarrollo de Cowork antes de planificar el empaquetado o la publicación.
Use un SDK en la ruta de acceso de la aplicación cuando necesite su propia orquestación, modelos, hospedaje o tiempo de ejecución. No mueva el desarrollo de aplicaciones de motor personalizado al flujo de trabajo del complemento solo porque también usa servicios de Microsoft 365.
Registrar el plan de compilación
Para cada componente, registre:
- La tarea, la experiencia prevista y el formato documentado del componente.
- Tanto si crea un nuevo componente, configura el origen existente o utiliza un flujo de trabajo de reutilización específico del producto.
- La herramienta de creación, el repositorio de origen o el entorno administrado, y el propietario responsable.
- Cuentas, suscripciones, permisos, servicios y usuarios de prueba necesarios.
- La herramienta que produce el artefacto y el método de distribución que lo acepta.
- Las pruebas en tiempo de ejecución y las pruebas necesarias antes de la prueba de & del paquete.
Un paquete compartido no significa una experiencia idéntica en todas partes. Las funcionalidades admitidas, la disponibilidad y la configuración necesaria varían según el producto, la ruta de publicación y el lanzamiento.
Siguiente paso
Entrar Compilar o reutilizar con Funcionalidades de compilación o reutilización para el complemento. Para crear un nuevo complemento, sigue Crear un complemento con WIQD. Si ya tiene una fuente de agente declarativo, siga Empaquetar un agente declarativo existente como complemento.