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 compilación o reutilización, implemente el componente de agente declarativo seleccionado en el plan de componentes. Este artículo le ayuda a elegir el procedimiento del producto y a confirmar la preparación del componente. Finaliza con un agente en funcionamiento, sus dependencias y pruebas de la integración del complemento.
No necesitas un agente para cada plugin. Para su propia orquestación, modelos, hospedaje o tiempo de ejecución, siga la ruta de la aplicación en su lugar.
Comprobar un agente existente antes de crear uno
Revise los usuarios previstos del agente existente, las experiencias compatibles, las instrucciones, el conocimiento, las acciones, los permisos y las limitaciones conocidas con su propietario.
Verificar: Sus capacidades documentadas coinciden con la experiencia de tarea y destino del plan de componentes.
Selecciona la ruta documentada de reutilización o extensión del producto. Puede empezar con una plantilla de agente o copiar un agente de Agent Builder en Copilot Studio cuando se ajuste ese flujo de trabajo.
Verificar: La ruta admite el origen y el destino. No asuma que agregar un componente de agente a un complemento importa un proyecto existente.
Acordar la propiedad, el control de versiones, el soporte técnico y la administración de cambios, y luego probar las tareas representativas.
Verificar: Registre los resultados y las brechas sin resolver antes de decidir usar el agente sin cambios, configurarlo o crear un nuevo componente.
Empezar con Herramientas de desarrollo de Work IQ
Para el desarrollo profesional, comience con Work IQ Dev Tools, elija un entorno documentado y agregue Agents Toolkit solo cuando su componente necesite sus controles de proyecto específicos.
| Su punto de partida | Procedimiento del producto | Resultados esperados |
|---|---|---|
| Un nuevo complemento que necesita un componente de agente | Crear un complemento con las herramientas de desarrollo de Work IQ |
wiqd plugin create crea el contenedor; wiqd plugin add agent Aplica scaffolding al componente de agente opcional. |
| Un proyecto de origen de agente declarativo existente | Ciclo de vida de los componentes del agente | Continúe la creación y la iteración específicas del agente con los comandos documentados wiqd agent . |
| Instrucciones, conocimientos o acciones del agente que hay que editar | Agentes declarativos en WIQD y la referencia de comandos | Origen guardado configurado para el componente y el entorno seleccionados. |
Utilice el complemento WIQD coding-assistant para el trabajo guiado o la CLI directa para comandos repetibles. Instale el complemento del asistente de codificación y la CLI como requisitos previos independientes cuando sea necesario. GitHub Copilot ayuda a crear archivos, instrucciones, configuración y pruebas; no reemplaza los requisitos de herramientas, tiempo de ejecución o componentes de creación.
Para un proyecto de agente existente, seleccione explícitamente la validación sin conexión:
wiqd agent validate --mode source --env dev
Verificar: Lea los resultados de la fuente guardada y corrija los errores notificados. Una comprobación de origen superada no establece el comportamiento en tiempo de ejecución, la accesibilidad del punto de conexión, la exactitud de la autenticación o la aceptación del paquete final. El modo predeterminado package consume un archivo ZIP existente, lo carga para su validación y puede requerir el inicio de sesión.
Para agregar una aptitud a un proyecto de agente WIQD existente, compruebe la marca de características y los requisitos de agent-skills esquema actuales en la referencia de comandos de aptitudes de agente. Una habilidad de complemento de nivel superior y una habilidad adjunta a un agente declarativo son registros diferentes; ninguno establece soporte en todos los hosts.
Usar otra ruta de producto cuando se ajuste al componente
| Requisito | Procedimiento del producto |
|---|---|
| Creación administrada en Microsoft 365 Copilot | Introducción a Agent Builder y Compilar agentes |
| Lógica de bajo código, entornos administrados o conectores de Power Platform | Copilot Studio y Conectar y configurar un agente para Teams y Microsoft Copilot |
| Manifiestos de agente de nivel inferior e integraciones de desarrollo compatibles | Herramientas de desarrollo de Work IQ (recomendadas para escenarios compatibles con código profesional) |
| Aptitudes en un agente del kit de herramientas existente | Agregar habilidades con el Kit de herramientas de agentes |
Los agentes independientes de Copilot Studio aparecen en el Registro de agentes, no en complementos. No asuma que al publicar un agente independiente se vuelve a empaquetar como un complemento.
Configuración y prueba del agente
Para conocer los pasos de implementación detallados, siga la guía de productos del agente declarativo:
| Trabajo para completar | Instrucciones autorizadas | Verificar |
|---|---|---|
| Definir identidad, comportamiento, límites de tareas y temas de conversación | Compilar agentes o Compilar con JSON y, a continuación, escribir instrucciones eficaces | Las consultas representativas producen el comportamiento esperado y se mantienen dentro de la tarea prevista. |
| Configurar conocimientos y funcionalidades | Orígenes de conocimiento y Agregar funcionalidades y acciones personalizadas | Los datos requeridos están disponibles para el usuario previsto y no cuando los permisos no lo permiten. |
| Agregar acciones de MCP o API compatibles | Complementos de MCP y API para agentes declarativos | La selección de herramientas, la autenticación, el consentimiento, las confirmaciones, los errores y las solicitudes no admitidas se comportan según lo previsto. |
| Agregar una aptitud compatible | Habilidades en agentes declarativos y el procedimiento de creación seleccionado | El agente de destino carga la habilidad y completa la tarea definida dentro de los límites de ese producto. |
| Administrar la configuración de la ruta de creación | Entornos y versiones del kit de herramientas o entornos WIQD | Los valores de identidad, las dependencias y la configuración pertenecen al entorno de prueba previsto. |
Registre la versión del agente, el propietario, las experiencias compatibles, las dependencias, las limitaciones conocidas y los resultados de la prueba. Se requieren pruebas específicas del producto; Pasar la validación de paquete o origen no es evidencia de que todos los usuarios puedan ejecutar la tarea.
Para obtener instrucciones de diseño, consulte Procedimientos recomendados para agentes declarativos y Cómo elige las acciones el orquestador de Copilot. Cuando el comportamiento requerido funciona, puede habilitar opcionalmente los comentarios de los usuarios y optimizar la recuperación de contenido.
Siguiente paso
Continúe con los componentes restantes en Compilar o reutilizar. Cuando estén listos, ingrese al paquete & pruebe con Integrar y pruebe los componentes.