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.
En este artículo se describe el esquema 1.7 usado por el manifiesto del agente declarativo. El manifiesto es un documento legible por máquina que proporciona un modelo de lenguaje grande (LLM) con las instrucciones, conocimientos y acciones necesarios para especializarse en solucionar un conjunto selecto de problemas de usuario. El manifiesto de aplicación de Microsoft 365 hace referencia a manifiestos de agente declarativo dentro de un paquete de aplicación. Para obtener más información, consulte la referencia del manifiesto de aplicación de Microsoft 365.
Los agentes declarativos son valiosos para comprender y generar texto similar a humano, lo que los hace versátiles para tareas como escribir y responder preguntas. Esta especificación se centra en el manifiesto del agente declarativo que actúa como un marco estructurado para especializar y mejorar las funcionalidades que necesita un usuario específico.
Cambios de la versión anterior
Esta versión de esquema presenta los siguientes cambios de la versión 1.6:
- Se agregó la propiedad opcional
editorial_answerspara definir pares de preguntas y respuestas predefinidos que el agente puede usar para responder a las consultas de usuario en función de la similitud semántica. - Se agregó la propiedad opcional
default_response_modeal objeto behavior overrides para controlar el modo de respuesta predeterminado para el agente. - Se agregó la propiedad opcional
depends_onal objeto de inicio de conversación para especificar las dependencias de funcionalidad para los inicios de conversación.
Esquema JSON
Puede encontrar el esquema descrito en este documento en formato de esquema JSONaquí.
Convenciones
Referencias relativas en direcciones URL
A menos que se especifique lo contrario, todas las propiedades que son direcciones URL pueden ser referencias relativas. Las referencias relativas en el documento de manifiesto son relativas a la ubicación del documento de manifiesto.
Longitud de cadena
A menos que se especifique lo contrario, limite todas las propiedades de cadena a 4000 caracteres. Esta longitud de cadena no establece un tamaño aceptable para todas las propiedades de cadena del documento. Las implementaciones pueden establecer sus propios límites prácticos en la longitud del manifiesto.
Propiedades no reconocidas
Los objetos JSON definidos en este documento solo admiten las propiedades descritas. Las propiedades no reconocidas o extrañas en cualquier objeto JSON hacen que todo el documento no sea válido.
Localización de cadenas
Las cadenas localizables pueden usar una clave de localización en lugar de un valor literal. La sintaxis es [[key_name]], donde key_name es el nombre clave de la localizationKeys propiedad de los archivos de localización. Para obtener más información sobre la localización, consulte Localización del agente.
Objeto de manifiesto del agente declarativo
La raíz del documento de manifiesto es un objeto JSON que cubre los campos, funcionalidades, inicios de conversación y acciones necesarios.
El objeto de manifiesto del agente declarativo contiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
version |
Cadena | Obligatorio. Versión del esquema. Establecer av1.7. |
id |
Cadena | Opcional. Identificador del manifiesto. |
name |
Cadena | Obligatorio. Localizable. Nombre del agente declarativo. Debe contener al menos un carácter nowhitespace y tener 100 caracteres o menos. |
description |
Cadena | Obligatorio. Localizable. Descripción del agente declarativo. Debe contener al menos un carácter nowhitespace y tener 1000 caracteres o menos. |
instructions |
Cadena | Obligatorio. Instrucciones detalladas o instrucciones sobre cómo debe comportarse el agente declarativo, sus funciones y cualquier comportamiento que se evite. Debe contener al menos un carácter nowhitespace y tener 8000 caracteres o menos. |
capabilities |
Matriz del objeto Capabilities | Opcional. Contiene una matriz de objetos que definen las funcionalidades del agente declarativo. La matriz no puede contener más de uno de cada tipo derivado de objeto Capabilities. |
conversation_starters |
Matriz del objeto de inicio de conversación | Opcional. Título y texto son localizables. Una lista de ejemplos de preguntas que el agente declarativo puede responder. La matriz no puede contener más de 12 objetos. |
actions |
Matriz del objeto Action | Opcional. Lista de entre 1 y 10 objetos que identifican complementos que proporcionan acciones accesibles para el agente declarativo. |
behavior_overrides |
El comportamiento invalida el objeto | Opcional. Contiene valores de configuración que modifican el comportamiento del agente. |
disclaimer |
Objeto De declinación de responsabilidades | Opcional. Texto de declinación de responsabilidades que se muestra al usuario al inicio de una conversación. |
sensitivity_label |
Objeto de etiqueta de confidencialidad | Opcional. Especifica una etiqueta de confidencialidad de Microsoft Purview para el agente. |
editorial_answers |
Objeto de respuestas editoriales | Opcional. Contiene pares de preguntas y respuestas predefinidos que el agente puede usar para responder a las consultas de usuario en función de la similitud semántica. |
worker_agents |
Matriz del objeto del agente de trabajo | Opcional. Especifica otros agentes declarativos que puede usar este agente. |
user_overrides |
Matriz del objeto de invalidación de usuario | Opcional. Especifica las funcionalidades de la capabilities propiedad que el usuario puede modificar. |
Ejemplo de objeto de manifiesto de agente declarativo
En el código siguiente se muestra un ejemplo de los campos necesarios en un manifiesto de agente declarativo.
{
"version": "v1.7",
"name": "Repairs agent",
"description": "This declarative agent is meant to help track any tickets and repairs",
"instructions": "This declarative agent needs to look at my Service Now and Jira tickets/instances to help me keep track of open items"
}
Objeto Capabilities
El objeto capabilities es el tipo base de los objetos de la capabilities propiedad del objeto de manifiesto del agente declarativo. Los posibles tipos de objeto son:
- Objeto de búsqueda web
- OneDrive y el objeto de SharePoint
- Copilot connectors (objeto)
- Objeto de arte gráfico
- Objeto de intérprete de código
- Dataverse (objeto)
- Objeto de mensajes de Microsoft Teams
- Email (objeto)
- Objeto de persona
- Objeto De modelos de escenario
- Meetings (objeto)
- Objeto de conocimiento incrustado
Nota:
Los usuarios pueden acceder a agentes declarativos con cualquier funcionalidad que no sea búsqueda web solo si sus inquilinos permiten el uso medido o si tienen una licencia de Microsoft 365 Copilot.
Ejemplo de objeto Capabilities
{
"capabilities": [
{
"name": "WebSearch",
"sites": [
{
"url": "https://contoso.com"
}
]
},
{
"name": "OneDriveAndSharePoint",
"items_by_sharepoint_ids": [
{
"site_id": "bc54a8cc-8c2e-4e62-99cf-660b3594bbfd",
"web_id": "a5377427-f041-49b5-a2e9-0d58f4343939",
"list_id": "78A4158C-D2E0-4708-A07D-EE751111E462",
"unique_id": "304fcfdf-8842-434d-a56f-44a1e54fbed2"
}
],
"items_by_url": [
{
"url": "https://contoso.sharepoint.com/teams/admins/Documents/Folders1"
}
]
},
{
"name": "GraphConnectors",
"connections": [
{
"connection_id": "jiraTickets"
}
]
},
{
"name": "GraphicArt"
},
{
"name": "CodeInterpreter"
},
{
"name": "Dataverse",
"knowledge_sources": [
{
"host_name": "organization.crm.dynamics.com",
"skill": "DVCopilotSkillName",
"tables": [
{
"table_name": "account"
},
{
"table_name": "opportunity"
}
]
}
]
},
{
"name": "TeamsMessages",
"urls": [
{
"url": "https://teams.microsoft.com/l/channel/19%3ApO0102YGEBRSH6RziXCxEgB4mtb7-5hIlDzAjtxs_dg1%40thread.tacv2/G%C3%A9n%C3%A9ral?groupId=2670cf94-acf5-48f4-96d4-c58dd8937afc&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47"
}
]
},
{
"name": "People"
},
{
"name": "ScenarioModels",
"models": [
{
"id": "model_id"
}
]
},
{
"name": "Meetings",
"items_by_id": [
{
"id": "010000002300A00045B6C7890D12E0030000000040056F7GH890IJ01000000000000000020000000J3L45M6A7NO8PQ9R0S12TUV340XY5Z00",
"is_series": true
}
]
}
]
}
Objeto de búsqueda web
Indica que el agente declarativo puede buscar información de conexión a tierra en la web.
El objeto de búsqueda web contiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
name |
Cadena | Obligatorio. Se debe establecer en WebSearch. |
sites |
Matriz del objeto Site | Opcional. Matriz de objetos que identifican sitios en los que el agente puede buscar. Si omite esta propiedad, el agente puede buscar en todos los sitios. La matriz no puede contener más de cuatro elementos. |
Nota:
Para obtener más información sobre los datos, la privacidad y la seguridad de la búsqueda web en Microsoft 365 Copilot Chat y Microsoft 365 Copilot, consulte Datos, privacidad y seguridad para la búsqueda web.
Objeto del sitio
Indica un sitio en el que un agente declarativo puede buscar contenido.
El objeto de sitio contiene la siguiente propiedad.
| Propiedad | Tipo | Descripción |
|---|---|---|
url |
Cadena | Obligatorio. Dirección URL absoluta a un sitio en el que se va a buscar contenido. La dirección URL no puede contener más de dos segmentos de ruta de acceso (por ejemplo, https://contoso.com/projects/mark-8 es válida, pero https://contoso.com/projects/mark-8/beta-program no es válida). La dirección URL no puede contener ningún parámetro de consulta. |
OneDrive y el objeto de SharePoint
Indica que el agente declarativo puede buscar información de base en SharePoint y OneDrive de un usuario.
El objeto OneDrive y SharePoint contiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
name |
Cadena | Obligatorio. Se debe establecer en OneDriveAndSharePoint. |
items_by_sharepoint_ids |
Matriz de elementos por objeto de identificadores de SharePoint | Opcional. Matriz de objetos que identifican orígenes de SharePoint o OneDrive mediante identificadores. Si omite las items_by_sharepoint_ids propiedades y items_by_url , el agente declarativo puede acceder a todos los orígenes de OneDrive y SharePoint de la organización. |
items_by_url |
Matriz de elementos por objeto URL | Opcional. Matriz de objetos que identifican orígenes de SharePoint o OneDrive por dirección URL. Si omite las items_by_sharepoint_ids propiedades y items_by_url , el agente declarativo puede acceder a todos los orígenes de OneDrive y SharePoint de la organización. |
Para obtener información sobre cómo optimizar el contenido de SharePoint para Copilot, vea Optimizar la recuperación de contenido de SharePoint.
Objeto Items by SharePoint IDs (Elementos por identificadores de SharePoint)
El objeto items by SharePoint IDs contiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
site_id |
Cadena | Opcional. Identificador GUID único para un sitio de SharePoint o OneDrive. |
web_id |
Cadena | Opcional. Identificador GUID único para una web específica dentro de un sitio de SharePoint o OneDrive. |
list_id |
Cadena | Opcional. Identificador GUID único para una biblioteca de documentos dentro de un sitio de SharePoint. |
unique_id |
Cadena | Opcional. Identificador GUID único que se usa para establecer el ámbito de una carpeta o archivo en la biblioteca de documentos especificada por la list_id propiedad . |
search_associated_sites |
Booleano | Opcional. Indica si se va a habilitar la búsqueda de sitios asociados. Este valor solo es aplicable cuando el site_id valor hace referencia a una instancia de SharePoint HubSite. |
part_type |
Cadena | Opcional. Indica el tipo de elemento part_id al que hace referencia. Este valor solo es aplicable cuando el part_id valor está presente. Los valores posibles son: OneNotePart. |
part_id |
Cadena | Opcional. Identificador GUID único que se usa para representar parte de un elemento de SharePoint, como una página de OneNote. |
Sugerencia
Para obtener información sobre cómo obtener los identificadores únicos de un recurso de SharePoint o OneDrive, vea Recuperación de identificadores de funcionalidades para el manifiesto de agente declarativo.
Elementos por objeto URL
Los elementos por objeto URL contienen la siguiente propiedad.
| Propiedad | Tipo | Descripción |
|---|---|---|
url |
Cadena | Opcional. Dirección URL absoluta a un recurso de SharePoint o OneDrive. |
Copilot connectors (objeto)
Indica que el agente declarativo puede buscar información de puesta a tierra en los conectores copilot seleccionados.
El objeto de conectores de Copilot contiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
name |
Cadena | Obligatorio. Se debe establecer en GraphConnectors. |
connections |
Matriz del objeto Connection | Opcional. Matriz de objetos que identifican los conectores de Copilot disponibles para el agente declarativo. Si omite esta propiedad, el agente declarativo puede acceder a todos los conectores de Copilot de la organización. |
Connection (objeto)
Identifica un conector copilot.
El objeto de conexión contiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
connection_id |
Cadena | Obligatorio. Identificador único del conector de Copilot. |
additional_search_terms |
Cadena | Opcional. Consulta de Lenguaje de consulta por palabra clave (KQL) para filtrar elementos en función de los campos del esquema de la conexión. |
items_by_external_id |
Matriz del objeto de identificador de elemento | Opcional. Especifica elementos específicos por identificador en el conector de Copilot que están disponibles para el agente. |
items_by_external_url |
Matriz del objeto de dirección URL externa | Opcional. Especifica elementos específicos por dirección URL en el conector de Copilot que están disponibles para el agente. |
items_by_path |
Matriz del objeto Path | Opcional. Filtra los elementos disponibles para el agente por rutas de acceso de elementos (la itemPathetiqueta semántica en los elementos). |
items_by_container_name |
Matriz del objeto Nombre de contenedor | Opcional. Filtra los elementos disponibles para el agente por nombre de contenedor (la containerName etiqueta semántica en los elementos). |
items_by_container_url |
Matriz del objeto de dirección URL del contenedor | Opcional. Filtra los elementos disponibles para el agente por dirección URL del contenedor (la containerUrl etiqueta semántica en los elementos). |
Sugerencia
Para obtener instrucciones sobre cómo obtener el identificador único de un conector de Copilot, consulte Recuperación de identificadores de funcionalidades para el manifiesto de agente declarativo.
Objeto de identificador de elemento
Identifica un elemento externo por su identificador.
El objeto de identificador de elemento contiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
item_id |
Cadena | Obligatorio. Identificador único del elemento externo. |
Objeto DE DIRECCIÓN URL externa
Identifica un elemento externo por su dirección URL.
El objeto de dirección URL externa contiene la siguiente propiedad.
| Propiedad | Tipo | Descripción |
|---|---|---|
url |
Cadena | Obligatorio. Dirección URL del elemento externo. |
Path (objeto)
Identifica un elemento externo por su ruta de acceso.
El objeto path contiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
path |
Cadena | Obligatorio. Ruta de acceso (itemPath valor de etiqueta semántica) del elemento externo. |
Objeto de nombre de contenedor
Identifica un contenedor por su nombre.
El objeto de nombre de contenedor contiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
container_name |
Cadena | Obligatorio. Nombre del contenedor (containerName valor de etiqueta semántica) del elemento externo. |
Objeto de dirección URL del contenedor
Identifica un contenedor por su dirección URL.
El objeto de dirección URL del contenedor contiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
container_url |
Cadena | Obligatorio. Dirección URL del contenedor (containerUrl valor de etiqueta semántica) del elemento externo. |
Objeto de arte gráfico
Indica que el agente declarativo puede crear imágenes y arte en función de la entrada de texto del usuario. Para obtener más información, vea Generador de imágenes.
El objeto de arte gráfico contiene la siguiente propiedad.
| Propiedad | Tipo | Descripción |
|---|---|---|
name |
Cadena | Obligatorio. Establecer aGraphicArt. |
Objeto de intérprete de código
Indica que el agente declarativo puede generar y ejecutar código de Python para resolver problemas matemáticos complejos, analizar datos, generar visualizaciones y mucho más. Para obtener más información, vea Intérprete de código.
El objeto de intérprete de código contiene la siguiente propiedad.
| Propiedad | Tipo | Descripción |
|---|---|---|
name |
Cadena | Obligatorio. Establecer aCodeInterpreter. |
Dataverse (objeto)
Indica que el agente declarativo puede realizar búsquedas a través de datos de tablas en Dataverse.
El objeto Dataverse contiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
name |
Cadena | Obligatorio. Establecer aDataverse. |
knowledge_sources |
Matriz de orígenes de conocimiento | Opcional. Matriz de objetos que contienen los identificadores, aptitudes y nombres de tabla para que las instancias de Dataverse incluyan como conocimiento. |
Objeto de orígenes de conocimiento
Contiene información sobre las instancias de Dataverse que se van a incluir como conocimiento.
El objeto de orígenes de conocimiento contiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
host_name |
Cadena | Obligatorio. Identificador único para el host en Dataverse. |
skill |
Cadena | Identificador único que define la configuración de cómo interactúa el agente con el conocimiento de Dataverse. |
tables |
Matriz de tablas | Matriz de tablas para limitar el conocimiento del agente. |
Para buscar el identificador único skill de los orígenes de conocimiento de Dataverse que desea incluir:
- En Copilot Studio, en el panel izquierdo, elija Agentes>Copilot para Microsoft 365 y seleccione Agregar para crear un nuevo agente.
- Siga las instrucciones de Incorporación de un origen de conocimiento de Dataverse para agregar conocimientos de Dataverse.
- Seleccione Publicar y, a continuación, descargue el archivo .zip.
- Descomprima y abra el archivo declarativeAgent.json.
- El
skillvalor se incluye en laknowledge_sourcessección , como se muestra en el ejemplo siguiente.
{
"name": "Dataverse",
"knowledge_sources": [
{
"host_name": "org0f612cfc.crm.dynamics.com",
"skill": "AIBuilderFileAttachedData_e7eTReDbkX_1t4X1oGoCF",
"tables": [
{
"table_name": "msdyn_aibfileattacheddata"
}
]
}
]
}
Tables (objeto)
Contiene las tablas para limitar el conocimiento del agente.
El objeto tables contiene la siguiente propiedad.
| Propiedad | Tipo | Descripción |
|---|---|---|
table_name |
Cadena | Obligatorio. Identificador único de la tabla. |
Objeto de mensajes de Microsoft Teams
Indica que el agente declarativo puede buscar en canales de Microsoft Teams, equipos, reuniones, chats 1:1 y chats de grupo.
El objeto de mensajes de Microsoft Teams contiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
name |
Cadena | Obligatorio. Establecer aTeamsMessages. |
urls |
Matriz de direcciones URL de Microsoft Teams | Opcional. Matriz de objetos que identifican las direcciones URL de los canales de Microsoft Teams, los chats de reunión, los chats de grupo o los chats 1:1 disponibles para el agente declarativo. La matriz no puede contener más de cinco objetos. Si omite esta propiedad, el agente declarativo puede buscar en todos los canales, reuniones, chats 1:1 y chats de grupo. |
Objeto URL de Microsoft Teams
Identifica un canal de Microsoft Teams, un equipo o un chat de reunión.
El objeto URL de Microsoft Teams contiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
url |
Cadena | Obligatorio. Una dirección URL de Microsoft Teams con formato correcto que se vincula a un canal de Microsoft Teams, un chat de reunión, un chat de grupo o un chat 1:1. |
Email (objeto)
Indica que el agente declarativo puede buscar mensajes de correo electrónico en los buzones a los que el usuario tiene acceso.
El objeto de correo electrónico contiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
name |
Cadena | Obligatorio. Se debe establecer en Email. |
shared_mailbox |
Cadena | Opcional. Dirección SMTP de un buzón compartido. |
group_mailboxes |
Matriz de cadenas | Opcional. Matriz de direcciones SMTP de Grupos de Microsoft 365 o buzones compartidos. Se admiten un máximo de 25 buzones. |
folders |
Matriz de carpetas | Opcional. Si está presente, solo está disponible el correo electrónico en las carpetas especificadas para el agente. |
Folders (objeto)
Contiene las carpetas para limitar el conocimiento del agente.
El objeto folders contiene la siguiente propiedad.
| Propiedad | Tipo | Descripción |
|---|---|---|
folder_id |
Cadena | Obligatorio. Nombre de carpeta conocido o identificador de carpeta de la carpeta a la que se va a hacer referencia. |
Objeto de persona
Indica que el agente declarativo puede buscar información sobre las personas de la organización. Consulte People conocimientos para obtener más información sobre los datos devueltos por la funcionalidad People base.
El objeto people contiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
name |
Cadena | Obligatorio. Se debe establecer en People. |
include_related_content |
Booleano | Opcional. Indica si se debe incluir contenido relacionado al buscar datos de personas. Cuando se establece en true, la DA incluirá documentos relacionados, correos electrónicos y mensajes de Teams entre el usuario del agente y las personas a las que se hace referencia (es decir, lo que tienen en común). Cuando se establece en false o se omite, solo se incluirá información básica de la organización, como gráficos de organización, nombres, direcciones de correo electrónico y aptitudes. El valor predeterminado es False. |
Objeto De modelos de escenario
Indica que el agente declarativo puede usar modelos específicos de la tarea.
El objeto de modelos de escenario contiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
name |
Cadena | Obligatorio. Se debe establecer en ScenarioModels. |
models |
Matriz del objeto Model | Obligatorio. Matriz de objetos que identifica los modelos específicos de la tarea disponibles para el agente declarativo. |
Model (objeto)
Identifica un modelo específico de la tarea.
El objeto de modelo contiene la siguiente propiedad.
| Propiedad | Tipo | Descripción |
|---|---|---|
id |
Cadena | Obligatorio. Identificador único del modelo. |
Meetings (objeto)
Indica que el agente declarativo puede buscar información sobre las reuniones de la organización.
El objeto meetings contiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
name |
Cadena | Obligatorio. Se debe establecer en Meetings. |
items_by_id |
Matriz del objeto de identificador de reunión | Opcional. Matriz de objetos que identifican las reuniones disponibles para el agente declarativo. La matriz no puede contener más de cinco objetos. Si omite esta propiedad, el agente declarativo puede buscar en todas las reuniones. |
Objeto de identificador de reunión
Identifica una reunión.
El objeto de identificador de reunión contiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
id |
Cadena | Obligatorio. Identificador único de la reunión. Para obtener instrucciones sobre cómo buscar el identificador de una reunión, consulte Obtención del identificador de una reunión. |
is_series |
Booleano | Obligatorio. Indica si la reunión es una serie. |
Objeto de conocimiento incrustado
Indica que el agente declarativo puede usar archivos localmente en el paquete de la aplicación.
Importante
Esta característica aún no está disponible.
Los archivos de conocimiento insertados tienen un tamaño máximo de archivo de 1 MB y deben ser uno de los siguientes tipos de documento:
- documento Word (.doc, .docx)
- Presentación de PowerPoint (.ppt, .pptx)
- Libro de Excel (.xls, .xlsx)
- Texto sin formato (.txt)
- Portable Document Format (.pdf)
El objeto de conocimiento incrustado contiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
name |
Cadena | Obligatorio. Se debe establecer en EmbeddedKnowledge. |
files |
Matriz del objeto File | Opcional. Lista de objetos que identifican archivos que contienen conocimientos que el agente puede usar para la puesta en tierra. El tamaño máximo de la matriz es 10. Debe especificar o embedded_resource_snapshot_idfiles, pero no ambos. |
Ejemplo de objeto EmbeddedKnowledge
{
"name": "EmbeddedKnowledge",
"files": [
{ "file": "file1.docx" },
{ "file": "file2.csv" }
]
}
Objeto File
| Propiedad | Tipo | Descripción |
|---|---|---|
file |
Cadena | Obligatorio. Ruta de acceso relativa al archivo para el archivo incrustado. |
Objeto Conversation Starters
El objeto starters de conversación es opcional en el manifiesto. Contiene sugerencias que el agente muestra al usuario para mostrar cómo puede empezar a trabajar con el agente declarativo.
El objeto de inicio de conversación contiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
text |
Cadena | Obligatorio. Localizable. Sugerencia que el usuario puede usar para obtener el resultado deseado del agente declarativo. Debe contener al menos un carácter nowhitespace. |
title |
Cadena | Opcional. Localizable. Un título único para el inicio de la conversación. Debe contener al menos un carácter nowhitespace. |
depends_on |
Matriz de depende del objeto | Opcional. Lista de objetos que especifican dependencias de funcionalidad para este inicio de conversación. Los inicios de conversación con dependencias solo se muestran a los usuarios cuando todas las funcionalidades a las que se hace referencia están presentes en el manifiesto del agente declarativo. |
Nota:
La matriz no puede contener más de 12 objetos.
Ejemplo de objeto conversation starters
{
"conversation_starters": [
{
"title": "My Open Repairs",
"text": "What open repairs are assigned to me?"
}
]
}
Depende del objeto
Especifica una dependencia para un inicio de conversación. Este objeto identifica un elemento de manifiesto que debe estar presente para que se muestre el inicio de la conversación.
El objeto depende de que contenga las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
name |
Cadena | Obligatorio. Nombre del tipo de elemento de manifiesto. Se debe configurar como capabilities. |
id |
Cadena | Obligatorio. Identificador del elemento específico. Por ejemplo, Email o WebSearch. |
Depende del ejemplo de objeto
{
"conversation_starters": [
{
"title": "Project Update",
"text": "Executive status report on [Project]",
"depends_on": [
{
"name": "capabilities",
"id": "Email"
},
{
"name": "capabilities",
"id": "WebSearch"
}
]
}
]
}
Actions (objeto)
Las acciones son un objeto JSON opcional en el manifiesto. Actúan como entrada del desarrollador y se pueden considerar como complementos. Un objeto de acción se puede especificar como referencia a un archivo de manifiesto de complemento mediante las id propiedades y file , o bien puede ser una representación insertada del objeto de manifiesto del complemento.
En la tabla siguiente se describen las propiedades de un objeto de acción al que se hace referencia.
| Propiedad | Tipo | Descripción |
|---|---|---|
id |
Cadena | Obligatorio. Identificador único de la acción. Puede ser un GUID. |
file |
Cadena | Obligatorio. Ruta de acceso al manifiesto del complemento de API para esta acción. |
Al especificar una acción como un manifiesto de complemento insertado, el objeto de acción debe cumplir la especificación del manifiesto del complemento .
Nota:
La matriz debe contener al menos uno y no más de 10 objetos.
Ejemplo de objeto Actions
En el ejemplo siguiente se muestra una acción especificada como referencia a un archivo de manifiesto de complemento.
{
"actions": [
{
"id": "repairsPlugin",
"file": "plugin.json"
}
]
}
En el ejemplo siguiente se muestra una acción con un manifiesto de complemento insertado.
{
"actions": [
{
"schema_version": "v2.4",
"name_for_human": "GitHub Issues Plugin",
"description_for_model": "Search for GitHub issues by author, keyword or state",
"runtimes": [
{
"type": "OpenApi",
"auth": { "type": "None" },
"spec": { "url": "https://github.com/ai/plugins/issues/openapi.yaml" }
}
]
}
]
}
El comportamiento invalida el objeto
Objeto JSON opcional que contiene valores de configuración que invalidan el comportamiento del agente.
El objeto de invalidación de comportamiento contiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
suggestions |
Objeto Suggestions | Opcional. Contiene los valores de configuración de la característica de sugerencias. |
special_instructions |
Objeto de instrucciones especiales | Opcional. Contiene la configuración para insertar instrucciones especiales en el símbolo del sistema. |
default_response_mode |
Cadena | Opcional. Modo de respuesta predeterminado para el agente. Esta propiedad tiene el prefijo default_ porque los usuarios siempre pueden invalidar este valor a través de la interfaz de usuario del selector de modelos. Para obtener más información, consulte Valores de modo de respuesta predeterminados. El valor predeterminado es Auto. |
Valores de modo de respuesta predeterminados
La default_response_mode propiedad permite a los autores de agentes configurar el modo predeterminado para sus agentes a partir de los modos disponibles en el selector de modelos de usuario. El valor debe ser uno de los siguientes.
-
Auto- El agente determina automáticamente el mejor modo de respuesta en función del contexto de la consulta del usuario, seleccionando de forma inteligente entre respuestas rápidas y razonamientos más profundos. Este es el valor predeterminado si no se especifica. -
Quick response- El agente proporciona respuestas rápidas optimizadas para interacciones de baja latencia. Este modo es adecuado para los agentes en los que la velocidad se prioriza en comparación con el razonamiento complejo. -
Think deeper- El agente usa el modo de razonamiento para proporcionar respuestas más reflexivas y completas. Este modo implica una mayor latencia, pero es adecuado para escenarios complejos de resolución de problemas en los que el análisis más profundo es beneficioso.
Los autores del agente deben tener en cuenta el caso de uso al seleccionar un modo. Por ejemplo, es posible que el aumento de la latencia implicado en el modo de razonamiento no sea adecuado para todos los agentes, mientras que es posible que algunos autores quieran invocar siempre el razonamiento para tareas analíticas complejas.
El cliente respeta el modo predeterminado configurado en el manifiesto. Los usuarios pueden invalidar este valor predeterminado a través del selector de modelos.
Nota:
El modo de respuesta predeterminado no se aplica cuando el agente se invoca a través @mention de la experiencia principal de Copilot. Este es un problema conocido.
Objeto Suggestions
Objeto JSON opcional que contiene los valores de configuración de la característica de sugerencias.
El objeto suggestions contiene la siguiente propiedad.
| Propiedad | Tipo | Descripción |
|---|---|---|
disabled |
Booleano | Obligatorio. Si se establece en true, la característica de sugerencias está deshabilitada. El valor predeterminado es false. |
Objeto de instrucciones especiales
Un objeto JSON opcional que contiene la configuración para insertar instrucciones especiales en el símbolo del sistema.
El objeto de instrucciones especiales contiene la siguiente propiedad.
| Propiedad | Tipo | Descripción |
|---|---|---|
discourage_model_knowledge |
Booleano | Obligatorio. Si se establece en true, el agente no usa el conocimiento del modelo al generar respuestas. El valor predeterminado es false. |
Objeto De declinación de responsabilidades
Una declinación de responsabilidades es un objeto JSON opcional en el manifiesto que especifica el texto de la declinación de responsabilidades. El agente muestra este texto al usuario al principio de una conversación.
El objeto de declinación de responsabilidades contiene la siguiente propiedad.
| Propiedad | Tipo | Descripción |
|---|---|---|
text |
Cadena | Obligatorio. Texto de declinación de responsabilidades. El valor debe contener al menos un carácter que no sea de espacio en blanco y no debe superar los 500 caracteres. |
Objeto de etiqueta de confidencialidad
Nota:
Las etiquetas de confidencialidad solo se aplican al agente cuando el agente tiene Files incrustado. Esta propiedad aún no está habilitada, ya que los Files incrustados aún no están habilitados.
Un objeto JSON opcional que especifica la etiqueta de confidencialidad de Microsoft Purview para los archivos incrustados dentro del agente. Contiene la protección más alta entre todos los archivos insertados en los agentes de la propiedad Embedded Knowledge.
| Propiedad | Tipo | Descripción |
|---|---|---|
id |
Cadena | GUID de la etiqueta de confidencialidad de Microsoft Purview. |
Ejemplo de objeto de etiqueta de confidencialidad
{
"sensitivity_label": {
"id": "<guid>"
}
}
Objeto de agente de trabajo
Identifica un agente declarativo que puede usar este agente. Consulte Conexión a otros agentes para obtener información sobre el uso y los procedimientos recomendados.
Nota:
Esta funcionalidad está en versión preliminar.
El objeto del agente de trabajo contiene la siguiente propiedad.
| Propiedad | Tipo | Descripción |
|---|---|---|
id |
Cadena | Identificador de título de la aplicación que contiene el agente declarativo. Esto se devuelve al publicar la aplicación con microsoft 365 Agents Toolkit o puede encontrarse en la sección de metadatos del agente de la tarjeta de modo de desarrollador. Debe especificar o idfile, pero no ambos. |
Objeto de invalidación de usuario
Identifica las funcionalidades configuradas en el objeto Capabilities que el usuario puede invalidar a través de un control de interfaz de usuario en Microsoft 365 Copilot. La única acción admitida es remove, que habilita un control de alternancia en la interfaz de usuario, lo que permite al usuario habilitar o deshabilitar la funcionalidad para que no se use para generar respuestas.
Nota:
Al declarar GraphConnectors en path, todos los conectores copilot disponibles pueden activarse o desactivarse. No es posible habilitar el botón de alternancia para conectores específicos. Los cubos del sistema y muestran los conectores proporcionados por Microsoft con un nombre descriptivo y conectores personalizados con el nombre del conector (por ejemplo, CB Insights). Este comportamiento garantiza que los usuarios finales puedan identificar y administrar fácilmente los orígenes del conector al configurar su sesión de agente. Para obtener más información sobre los conectores y publicadores, consulte Microsoft 365 Copilot Connectors Gallery.
El objeto de invalidación de usuario contiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
path |
Cadena | Obligatorio. Expresión JSONPath que identifica la funcionalidad que los usuarios pueden modificar. La expresión JSONPath permite dirigirse solo a funcionalidades específicas por nombre. |
allowed_actions |
Matriz de cadenas | Obligatorio. Especifica que se pueden realizar acciones para las funcionalidades especificadas. La única acción admitida es remove. |
Ejemplo de objeto de invalidación de usuario
En el ejemplo siguiente se habilitan los controles de alternancia para las funcionalidades de búsqueda web y mensajes de Microsoft Teams , lo que permite al usuario activar o desactivar las funcionalidades.
{
"user_overrides": [
{
"path": "$.capabilities[?(@.name == 'WebSearch')]",
"allowed_actions": ["remove"]
},
{
"path": "$.capabilities[?(@.name == 'TeamsMessages')]",
"allowed_actions": ["remove"]
}
]
}
Objeto de respuestas editoriales
Un objeto JSON opcional que contiene pares de preguntas y respuestas predefinidos que el agente puede usar para responder a las consultas del usuario en función de la similitud semántica. El objeto debe contener una url propiedad o una answers propiedad, pero no ambas.
El objeto de respuestas editoriales contiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
url |
Cadena | Dirección URL que busca un documento que contiene la configuración de respuestas editoriales. Debe especificar o urlanswers, pero no ambos. |
answers |
Matriz del objeto Answer | Matriz de objetos de par de preguntas y respuestas predefinidos. La matriz no puede contener más de 300 objetos. Debe especificar o urlanswers, pero no ambos. |
Answer (objeto)
Objeto JSON que contiene un par de preguntas y respuestas predefinido.
El objeto answer contiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
question |
Cadena | Obligatorio. Pregunta predefinida que se usa para la coincidencia de similitud semántica con las consultas de usuario. Debe contener al menos un carácter nowhitespace. |
answer |
Cadena | Obligatorio. Respuesta predefinida que se devuelve cuando la consulta del usuario coincide con la pregunta por encima del umbral de similitud. Debe contener al menos un carácter nowhitespace. |
similarity_thresholds |
Objeto umbrales de similitud | Opcional. Define los umbrales de similitud para hacer coincidir las consultas de usuario con esta pregunta. |
Objeto umbrales de similitud
Objeto JSON que contiene los valores de umbral de similitud mínima y máxima para la coincidencia semántica.
El objeto de umbrales de similitud contiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
min |
Número | Obligatorio. Umbral de similitud mínima. El valor debe ser un entero comprendido entre 0 y 10 inclusive. |
max |
Número | Obligatorio. Umbral de similitud máxima. El valor debe ser un entero comprendido entre 0 y 10 inclusive. |
Ejemplo de objeto de respuestas editoriales
{
"editorial_answers": {
"answers": [
{
"question": "What is the company's return policy?",
"answer": "Our company offers a 30-day return policy for all products purchased in-store or online.",
"similarity_thresholds": {
"min": 3,
"max": 8
}
},
{
"question": "How do I contact support?",
"answer": "You can contact our support team by emailing [email protected] or calling 1-800-555-0199."
}
]
}
}
Ejemplo de manifiesto de agente declarativo
En el ejemplo siguiente se muestra un archivo de manifiesto de agente declarativo que usa la mayoría de las propiedades de manifiesto descritas en este artículo.
{
"$schema": "https://developer.microsoft.com/json-schemas/copilot/declarative-agent/v1.7/schema.json",
"version": "v1.7",
"name": "Teams Toolkit declarative agent",
"description": "Declarative agent created with Teams Toolkit",
"instructions": "You are a repairs expert agent. With the response from the listRepairs function, you **must** create a poem out of the repairs listed and always include their title and the assigned person. The poem **must** not use the quote markdown and use regular text. If the user is asking to create a new repair, use the createRepair function and do not add poems.",
"conversation_starters": [
{
"title": "Getting Started",
"text": "How can I get started with Teams Toolkit?"
},
{
"title": "Getting Help",
"text": "How can I get help with Teams Toolkit?",
"depends_on": [
{
"name": "capabilities",
"id": "WebSearch"
}
]
}
],
"sensitivity_label": {
"id": "00000000-0000-0000-0000-000000000000"
},
"actions": [
{
"id": "repairsPlugin",
"file": "repairs-hub-api-plugin.json"
}
],
"behavior_overrides": {
"suggestions": {
"disabled": true
},
"special_instructions": {
"discourage_model_knowledge": true
},
"default_response_mode": "Auto"
},
"disclaimer": {
"text": "This declarative agent is a fictional example. You should not take it seriously."
},
"editorial_answers": {
"answers": [
{
"question": "What is the company's return policy?",
"answer": "Our company offers a 30-day return policy for all products purchased in-store or online.",
"similarity_thresholds": {
"min": 3,
"max": 8
}
}
]
},
"worker_agents": [
{
"id": "P_2c27ae89-1f78-4ef7-824c-7d83f77eda28"
}
],
"user_overrides": [
{
"path": "$.capabilities[?(@.name == 'OneDriveAndSharePoint')]",
"allowed_actions": [
"remove"
]
}
],
"capabilities": [
{
"name": "WebSearch",
"sites": [
{
"url": "https://contoso.com/projects/mark-8"
}
]
},
{
"name": "OneDriveAndSharePoint",
"items_by_url": [
{
"url": "https://contoso.sharepoint.com/sites/ProductSupport"
}
]
},
{
"name": "GraphConnectors",
"connections": [
{
"connection_id": "foodStore"
}
]
},
{
"name": "GraphicArt"
},
{
"name": "CodeInterpreter"
},
{
"name": "Dataverse",
"knowledge_sources": [
{
"host_name": "organization.crm.dynamics.com",
"skill": "DVCopilotSkillName",
"tables": [
{
"table_name": "account"
},
{
"table_name": "opportunity"
}
]
}
]
},
{
"name": "TeamsMessages",
"urls": [
{
"url": "https://teams.microsoft.com/l/channel/19%3ApO0102YGEBRSH6RziXCxEgB4mtb7-5hIlDzAjtxs_dg1%40thread.tacv2/G%C3%A9n%C3%A9ral?groupId=2670cf94-acf5-48f4-96d4-c58dd8937afc&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47"
}
]
},
{
"name": "Email",
"shared_mailbox": "[email protected]",
"folders": [
{
"folder_id": "inbox"
}
]
},
{
"name": "People"
},
{
"name": "ScenarioModels",
"models": [
{
"id": "model_id"
}
]
},
{
"name": "Meetings",
"items_by_id": [
{
"id": "010000002300A00045B6C7890D12E0030000000040056F7GH890IJ01000000000000000020000000J3L45M6A7NO8PQ9R0S12TUV340XY5Z00",
"is_series": true
}
]
},
{
"name": "EmbeddedKnowledge",
"files": [
{ "file": "file1.docx" },
{ "file": "file2.csv" }
]
}
]
}