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.
Los agentes declarativos personalizan Microsoft 365 Copilot para escenarios empresariales específicos a través de instrucciones, orígenes de conocimiento y funcionalidades admitidas. Use estas prácticas para mantener un agente enfocado, configurar sus acciones de manera segura y evaluar su comportamiento a medida que evoluciona.
Comience con un público definido, una tarea del usuario y el resultado esperado. Para conocer el límite entre el tiempo de ejecución administrado y los servicios que opera, consulte Arquitectura de agente declarativo.
Nota
En este artículo se tratan los agentes declarativos, que usan el tiempo de ejecución administrado de Copilot. Si va a crear un agente de motor personalizado que recupere los datos de conexión a tierra de Microsoft 365, siga los procedimientos recomendados de la API de recuperación y los permisos y limitaciones. Esa guía es independiente de la configuración de los orígenes de conocimiento de un agente declarativo.
Componentes del agente declarativo
Elija cada componente para admitir las tareas previstas del agente. Siga los límites en la herramienta de creación y el esquema de manifiesto seleccionados.
| Componente | Procedimiento recomendado |
|---|---|
| Nombre | Use un nombre distinto que transmita el propósito del agente. Agent Builder permite hasta 30 caracteres; El manifiesto de agente declarativo permite hasta 100. |
| Descripción | Resuma las tareas y el dominio en unas pocas frases precisas, dentro del límite de 1000 caracteres. Mantenga instrucciones detalladas de comportamiento en el campo de instrucciones. |
| Instrucciones | Defina el propósito del agente, las tareas admitidas, el uso de la fuente y la herramienta, el formato de salida y el comportamiento de falla dentro del límite de 8000 caracteres. |
| Orígenes de conocimiento | Agregue fuentes relevantes para las preguntas previstas. Confirme su ámbito, actualización, permisos y licencias admitidos. |
| Funcionalidades integradas | Habilite funcionalidades como el intérprete de código o el generador de imágenes solo cuando admitan las tareas previstas. |
| Aptitudes personalizadas (versión preliminar) | Use aptitudes para instrucciones de tareas modulares, recursos o scripts. Haga referencia a las habilidades configuradas a un alto nivel en lugar de duplicar sus instrucciones detalladas. |
| Acciones | Use complementos de MCP o API para interacciones compatibles con servicios externos. Describa el propósito, las entradas, las salidas y las condiciones de falla de cada herramienta. |
| Inicios de conversación | Proporcione indicaciones representativas que demuestren las tareas admitidas. No se requiere un número mínimo. Pruebe cada mensaje y siga los límites de la herramienta seleccionada. |
Procedimientos recomendados para instrucciones de agente
Use las instrucciones para definir cómo el agente debe abordar las tareas previstas:
- Indique el resultado y los límites. Describa lo que el agente ayuda a los usuarios a lograr, qué información necesita y cómo debe responder a las solicitudes no admitidas.
- Hacer explícito el uso de la fuente y la herramienta. Identifique qué origen, funcionalidad o acción configurados se aplican a cada tarea. Pregunte por las entradas que faltan en lugar de adivinar.
- Pasos separados de la presentación. Use pasos de tarea claros donde el orden sea importante y especifique el tono, la estructura y el nivel de detalle esperados para las respuestas.
- Planifique la información que falta y los errores. Describir cómo controlar orígenes no disponibles, resultados incompletos, acceso denegado y acciones incorrectas sin reclamar que se hayan realizado correctamente.
- Mantenga las instrucciones separadas del conocimiento. No ponga instrucciones de comportamiento en documentos de SharePoint u otras fuentes de conocimiento para eludir los límites de instrucciones. El contenido recuperado no es contenido de instrucciones de confianza creado por el creador.
Para obtener patrones detallados, ejemplos e instrucciones sobre los cambios en el modelo, consulte Escribir instrucciones eficaces. Para las tareas que combinan el conocimiento con las llamadas API, consulte Escribir instrucciones para agentes con complementos de API.
Elegir las fuentes de conocimiento adecuadas
Seleccione fuentes de conocimiento en función de las preguntas que debe responder el agente:
- Prefiere la relevancia a la cantidad. Ámbito los orígenes a los archivos, sitios, chats u otro contenido necesario para la tarea. Para SharePoint y archivos incrustados, siga Optimizar la recuperación de contenido.
- Haga coincidir la recuperación con los requisitos de frescura. Revise periódicamente el contenido de origen y la propiedad. La búsqueda web enfocada usa contenido indexado por Bing, no una consulta directa de los datos subyacentes. Para los datos estructurados actuales, en su lugar, evalúe una acción de API o MCP admitida. Consulta Fundamentación de búsqueda web y contenido dinámico.
- Confirme el acceso antes de compartir. Pruebe con usuarios que representen el público y los permisos previstos. Revise el comportamiento de uso compartido de archivos incrustados por separado del acceso a los archivos originales.
- Compruebe la compatibilidad de funcionalidades y licencias. Las opciones de origen y ámbito difieren según la herramienta de creación y la configuración del inquilino. Siga la matriz de soporte de fuentes de conocimiento y las instrucciones de licencias.
- Evalúe la conexión a tierra, no solo la fluidez de la respuesta. Pruebe las preguntas con respuestas conocidas y compruebe que las respuestas y las citas coinciden con las fuentes previstas. Incluya preguntas cuyas respuestas no estén disponibles.
Agregar orígenes por sí solo no impide que el agente use el conocimiento de modelo integrado. Cuando el escenario requiere respuestas fundamentadas en la fuente, establezca behavior_overrides.special_instructions.discourage_model_knowledge y true refuerce el uso de la fuente previsto en las instrucciones. Este control no garantiza que las respuestas usen solo orígenes configurados. Continúe evaluando la atribución y el comportamiento de la fuente cuando falten pruebas.
Consulte las respuestas terrestres a las fuentes de conocimiento configuradas y la referencia de instrucciones especiales.
Diseñar acciones seguras
Use acciones para las interacciones admitidas con servicios externos y distinga de las fuentes de conocimiento. Un conector Copilot usado para la conexión a tierra no es intercambiable con una herramienta API o MCP que cambia los datos externos.
- Describir las operaciones con precisión. Explicar cuándo se debe utilizar una herramienta, sus parámetros requeridos y sus resultados y errores esperados. Para las API de REST, siga las instrucciones en documentos de OpenAPI.
- Configure las confirmaciones para la integración. Para complementos de API, use la extensión
x-openai-isConsequentialOpenAPI , noisConsequential, y marque las operaciones con efectos secundarios como consecuentes. En el caso de las herramientas MCP, utilíceloreadOnlyHintsolo para herramientas de solo lectura. Siga las indicaciones de confirmación de los complementos de MCP y API para conocer la configuración y el comportamiento admitidos. - Forzar el acceso en el servicio. Use el método de autenticación admitido y valide la autorización y las entradas en el servicio externo. Las instrucciones y los avisos de confirmación no reemplazan esas comprobaciones.
- Diseño para fallos y solicitudes repetidas. Confirmaciones de prueba denegadas, autenticación caducada, entradas no válidas y errores de servicio. En el caso de las operaciones que cambian los datos, asegúrese de que los reintentos no repiten el cambio involuntariamente.
Use los datos, la privacidad y la seguridad del plan para identificar los flujos de datos, los permisos y los requisitos de supervisión humana para cada acción.
Probar e iterar
Defina el comportamiento esperado antes de cambiar el agente y mantenga un conjunto repetible de casos de prueba. Utilice la experiencia de prueba de la herramienta de creación para obtener comentarios tempranos y, a continuación, valide el agente implementado en sus hosts previstos.
| Área de prueba | Qué se debe comprobar |
|---|---|
| Tareas admitidas | Los inicios de conversación, las frases realistas del usuario y las preguntas de seguimiento producen los resultados esperados. |
| Falta información o no compatible | El agente solicita las entradas requeridas, explica la evidencia no disponible y no inventa hechos ni afirma que se completaron acciones fallidas. |
| Conexión a tierra y permisos | Las respuestas y las citas coinciden con las fuentes previstas. Pruebe a los usuarios con acceso diferente y confirme que la información restringida no está expuesta. |
| Acciones y errores | Compruebe el resultado externo real, así como la respuesta. Confirmaciones de prueba, cancelaciones, errores de autenticación, errores de servicio y solicitudes repetidas. |
| Experiencia de anfitrión | Pruebe todas las aplicaciones compatibles en las que piense implementar. Comprueba el contexto del documento, la presentación de la respuesta y las funcionalidades disponibles, en lugar de asumir un comportamiento idéntico en todas las aplicaciones. |
| Rendimiento y cambios | Mida los tiempos de respuesta y vuelva a ejecutar los casos de regresión después de cambios en las instrucciones, conocimientos, herramientas, aptitudes o comportamiento de la plataforma. |
Incluye a los usuarios que no escribieron las instrucciones para que las pruebas capturen frases y suposiciones inesperadas. Convierta los problemas reproducibles notificados por el usuario en casos de regresión.
Para el diseño de casos de prueba, las afirmaciones y la evaluación repetible, consulte Descripción general de la evaluación del agente. Para las comprobaciones de versión, consulte Validación de IA responsable y Validar y probar el complemento.
Contenido relacionado
- Compilar agentes con Agent Builder
- Compilar agentes con las herramientas de desarrollo de Work IQ (recomendadas para escenarios compatibles con código profesional)
- Escribir instrucciones eficaces para agentes declarativos
- Agregar orígenes de conocimiento al agente declarativo
- Solicitudes de confirmación para complementos de MCP y API
- Información general sobre la evaluación del agente
- Directrices de validación para agentes