Agregar orígenes de conocimiento al agente declarativo

Puede mejorar la experiencia del usuario de su agente declarativo agregando capacidades como el intérprete de código y el generador de imágenes y las fuentes de conocimiento para mejorar y personalizar el conocimiento de su agente. El objeto capabilities de la referencia del manifiesto y la sección Conocimientos de Microsoft 365 Copilot proporcionan varias opciones para desbloquear características para los usuarios. En este artículo se describen los orígenes de conocimiento que puede agregar a los agentes.

En la siguiente tabla se enumeran las funcionalidades y orígenes de conocimiento que puede configurar mediante Agent Builder en Microsoft 365 Copilot o Microsoft 365 Agents Toolkit e indica si los usuarios requieren una licencia de Microsoft 365 Copilot o uso medido para acceder a agentes con esa funcionalidad o fuente de conocimiento.

Origen de funcionalidad o conocimiento	Generador de agente	Kit de herramientas de agentes	¿Se requiere licencia o uso medido?
Intérprete de código	✅	✅	No
Generador de imágenes	✅	✅	No
Conectores de Copilot	✅	✅	Sí
SharePoint	✅	✅	Sí
OneDrive	✅	✅	Sí
Contenido del archivo incrustado	✅	❌	Sí
Búsqueda web	✅	✅	No
Búsqueda web enfocada	✅	✅	No
Dataverse	✅	✅*	Sí
Correo electrónico	✅	✅*	Sí (solo licencia)
Contactos	✅	✅	Sí (solo licencia)
Páginas de OneNote	✅	❌	No
Mensajes de Teams	✅	✅*	Sí (solo licencia)
Reuniones de Teams	✅	✅	Sí (solo licencia)

* La opción para definir el ámbito del conocimiento está disponible.

Conectores de Copilot

Los conectores de Microsoft 365 Copilot le permiten agregar datos de la organización al agente como información de conexión a tierra. Usa conectores de Copilot para ingerir los datos de la línea de negocio en Microsoft Graph, de modo que Copilot pueda razonar sobre los datos como información de base en las respuestas a los mensajes de los usuarios. Para obtener más información, consulte Introducción a los conectores de Microsoft 365 Copilot.

Para obtener información sobre cómo agregar conectores de Copilot como conocimiento al manifiesto de agente en Agents Toolkit, consulte el objeto conectores de Copilot.

Para obtener información sobre cómo agregar conectores de Copilot al agente en Agent Builder, consulte Conectores de Copilot.

SharePoint y OneDrive

Cuando configura el agente para usar contenido de SharePoint y OneDrive como conocimiento, Copilot busca archivos, carpetas o sitios de SharePoint y OneDrive a los que un usuario tiene acceso para obtener información de conexión a tierra.

Para obtener información sobre cómo agregar conocimientos de SharePoint y OneDrive a su manifiesto de agente en el Kit de herramientas de agentes, vea Objeto de OneDrive y SharePoint.

Para obtener información sobre cómo agregar conocimientos de SharePoint y OneDrive a su agente en Agent Builder, y para conocer los límites por agente y cómo se administran los permisos y las etiquetas de confidencialidad, consulte Contenido de SharePoint y OneDrive.

Nota:

Las fuentes de conocimiento de SharePoint y OneDrive requieren que el usuario que ha iniciado sesión tenga una licencia activa de Microsoft 365 Copilot. Si el usuario no tiene una licencia, las solicitudes fallan y se muestra el mensaje Lo sentimos, no pude responder.

Las cuentas de inquilino de experiencias digitales del cliente (CDX) sin una licencia de Copilot pueden publicar agentes, pero no pueden realizar la recuperación basada en SharePoint. Use la licencia de desarrollador de Microsoft 365 Copilot para probar escenarios en entornos que no sean de producción.

Búsqueda web y de ámbito web

La búsqueda web permite a los agentes usar el índice de búsqueda de Bing para responder a las indicaciones de los usuarios. Si habilita la búsqueda web en el agente, el agente puede devolver cualquier dato web en sus respuestas. También puede limitar el alcance de la búsqueda web a un máximo de cuatro sitios web públicos.

Importante

Los administradores de la organización pueden deshabilitar la búsqueda web de Copilot y de todos los agentes de su organización. Si los administradores deshabilitan la búsqueda web, los agentes con búsqueda web habilitada no informan de un error y no incluyen búsquedas web en su conocimiento. Las tarjetas de depuración del modo de desarrollador indican que la búsqueda web está habilitada si el agente la ha habilitado, incluso si los administradores la han deshabilitado. Para obtener más información, consulte Administrar escenarios de Microsoft 365 Copilot en el Centro de administración de Microsoft 365.

Agregar búsqueda web y ámbito web

Si usa Agents Toolkit y Visual Studio Code para crear el agente, agregue el valor a la propiedad capabilities en el archivo de manifiesto para habilitar la WebSearch búsqueda web. Para limitar el ámbito de la búsqueda web a sitios específicos, agregue la propiedad sites y especifique hasta cuatro direcciones URL, como se muestra en el ejemplo siguiente.

Nota:

Para agregar una búsqueda web limitada al agente, use la versión 1.3 o posterior del esquema de manifiesto de agente declarativo.

{
  "capabilities": [
    {
      "name": "WebSearch",
      "sites": [
        {
          "url": "cnn.com"
        }
      ]
    }
  ]
}

Si usa Agent Builder para crear su agente, en la pestaña Configurar , en Conocimiento, enumere las direcciones URL del sitio web a las que desea hacer referencia.

Fundamentación de búsqueda web y contenido dinámico

Cuando el manifiesto de un agente declarativo limita la búsqueda web a direcciones URL de sitios web específicos, el agente basa sus respuestas en el contenido que Bing indexa para esos sitios en lugar de en el acceso directo al origen de datos subyacente.

La búsqueda web enfocada se basa en el contenido que Bing indexa para los sitios web configurados. Como resultado, es posible que el contenido que depende de la representación del lado del cliente o de los datos generados dinámicamente no esté totalmente representado en los resultados de la búsqueda. En algunos casos, es posible que falte contenido cargado dinámicamente o que esté desactualizado en relación con lo que aparece en el sitio activo.

Este comportamiento puede producir resultados incoherentes. El contenido que se muestra en un sitio web puede diferir del contenido disponible para el agente, y es posible que el agente no devuelva de forma confiable los elementos más recientes de las listas que se generan dinámicamente o se actualizan con frecuencia.

Este comportamiento se espera con la arquitectura actual de agente declarativo. Los agentes declarativos no están diseñados para orígenes web generados dinámicamente o que no sean de OpenAPI, y estos escenarios pueden dar lugar a resultados de conexión a tierra incompletos o incoherentes.

Para acceder directamente a contenido estructurado que cambia con frecuencia, use un complemento de API respaldado por una especificación OpenAPI en lugar de una búsqueda web con alcance. Un complemento de API permite al agente consultar la fuente de datos subyacente directamente y usar parámetros de API, como la clasificación y los límites de resultados, en lugar de depender del contenido web indexado. Como alternativa, migre el contenido a un origen de conocimiento estático o basado en OpenAPI compatible. Para obtener orientación sobre estos enfoques, consulte:

Contenido del archivo incrustado

Si usa Agent Builder para crear su agente, puede cargar archivos directamente desde su dispositivo o en la nube para insertar el contenido y que su agente use como conocimiento. El contenido del archivo incrustado se almacena en SharePoint Embedded. Estos archivos influyen en la capacidad de OneDrive y SharePoint de su espacio empresarial.

Nota:

La característica de carga de archivos está disponible para los usuarios con facturación de uso habilitada o con una licencia de Microsoft 365 Copilot.
El contenido de archivos incrustados no se admite en entornos de Government Community Cloud (GCC) de Microsoft 365.

Para obtener más información sobre los archivos incrustados, consulte Contenido de archivos incrustados.

Importante

Las barreras de información (IB) de Microsoft Purview no se admiten en archivos incrustados. Cualquier usuario que pueda acceder al agente puede ver las respuestas fundamentadas en el contenido del archivo incrustado.

Dataverse

El conocimiento de Dataverse permite a los agentes responder en lenguaje natural a las consultas de los usuarios sobre sus datos de CRM o datos de tablas en Microsoft Dataverse. Puede agregar una instancia de Dataverse como origen de conocimiento y agregar sinónimos y un glosario para ayudar al sistema a interpretar mejor los datos personalizados en las tablas. Para obtener más información, consulte Agregar un origen de conocimiento de Dataverse.

Agregar conocimientos de Dataverse

Si usa Agent Builder para crear su agente, seleccione Dynamics 365 y Power Apps en la pestaña Configurar de la sección Conocimiento. Seleccione + para buscar la aplicación que desea incluir y seleccione la aplicación, o déjela como está para buscar en todas las aplicaciones. Puede acceder al conocimiento de Dataverse en Agent Builder a través de Business Applications en Work IQ, que un administrador debe habilitar primero.

Si usa Agents Toolkit y Visual Studio Code para crear el agente, agregue el valor a la propiedad en el archivo de manifiesto del agente para habilitar el Dataverse conocimiento de capabilities Dataverse, como se muestra en el ejemplo siguiente.

Nota:

Para agregar Dataverse conocimiento, use la versión 1.3 o posterior del esquema de manifiesto de agente declarativo.

{
  "capabilities": [
    {
      "name": "Dataverse",
      "knowledge_sources": [
        {
          "host_name": "YourOrgID.crm.dynamics.com",
          "skill": "DVCopilotSkillName",
          "tables": [
            {
              "table_name": "account"
            },
            {
              "table_name": "opportunity"
            }
          ]
        }
      ]
    }
  ]
}

Antes de agregar esta habilidad, asegúrese de que el valor de la matriz de skill capacidades existe en el entorno de Dataverse. Además, asegúrese de que el valor coincide con el host_name identificador de su organización.

Obtener un valor de aptitud preexistente o crear uno nuevo

Para capturar o crear un valor de Dataverse skill :

Obtenga el identificador de organización del portal > de creación de Power AppsConfiguración Recursos>para desarrolladores.

Obtenga un token de portador para autenticar y crear recursos de Dataverse. Para obtener un token de portador, cree un nuevo registro de aplicación en Azure Portal y, a continuación, ejecute la siguiente solicitud curl.

curl -X POST https://login.microsoftonline.com/<tenant_ID>/oauth2/v2.0/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "client_id=<client_ID>" \
  -d "scope=https://YourOrgID.crm.dynamics.com/.default" \
  -d "client_secret=<client_secret>" \
  -d "grant_type=client_credentials"

Determine si ya existe un skill valor mediante la siguiente solicitud de curl. Si ya existe un skill valor, la respuesta contiene una lista de aptitudes existentes DVTableSearch en su entorno de Dataverse.

AUTH="Bearer {TOKEN}"
ORG="https://YourOrgID.crm.dynamics.com"
API="$ORG/api/data/v9.1"

curl -s -X GET "$API/dvtablesearchs?\$select=dvtablesearchid,name,searchtype" \
-H "Authorization: $AUTH" \
-H "Accept: application/json"

Respuesta

{
 "@odata.context": "https://YourOrgID.crm.dynamics.com/api/data/v9.1/$metadata#dvtablesearchs(dvtablesearchid,name,se…),
 "value": [
   {
     "@odata.etag": "W/\"4277...\"",
     "dvtablesearchid": "15369...",
     "name": "User_Account_jSd6V...",
     "searchtype": 0
   }
]
}

Si ya existe un skill valor, utilícelo en el archivo de manifiesto del agente. Si el skill valor no existe, la respuesta contiene una matriz vacía.

Respuesta

{
  "@odata.context":"https://YourOrgID.crm.dynamics.com/api/data/v9.1/$metadata#dvtablesearchs(dvtablesearchid,name,searchtype)",
  "value":[]
}

Si no skill existe, cree una DVTableSearch aptitud y use el nombre que le asigne.

Solicitud

AUTH="Bearer {TOKEN}"
ORG="https://YourOrgID.crm.dynamics.com"
API="$ORG/api/data/v9.1"

curl -i -X POST "$API/dvtablesearchs" \
-H "Authorization: $AUTH" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
  "name": "Account_SystemUser_Skill",
  "searchtype": 0,
  "DVTableSearch_DVTableSearch_DVTableSearch": [
    {
      "name": "Account",
      "entitylogicalname": "account"
    }
  ]
}'

Respuesta

La solicitud devuelve 204 Sin contenido para indicar que la DVTableSearch aptitud se creó correctamente.

HTTP/1.1 204 No Content

Vuelva a ejecutar la solicitud curl en el paso 3 para comprobar si hay una aptitud existente DVTableSearch . La respuesta contiene el dvtablesearchid del archivo skill. Puede usar este valor o el name valor de la skill propiedad del archivo de manifiesto del agente.

Correo electrónico

El conocimiento de Email le permite limitar el ámbito del agente a un buzón personal o compartido y, opcionalmente, a una carpeta de buzón específica.

Agregar orígenes de conocimiento de correo electrónico

Si está utilizando Agent Builder para crear su agente, en la pestaña Configurar de la sección Conocimiento , seleccione Mis correos electrónicos.

Nota:

Actualmente, no puede limitar el ámbito de los correos electrónicos a una carpeta específica o a un buzón compartido cuando utiliza Agent Builder.

Si usa Agents Toolkit y Visual Studio Code para crear el agente, para agregar conocimientos de correo electrónico, agregue el Email valor a la propiedad capabilities en el archivo de manifiesto del agente, como se muestra en el ejemplo siguiente. Puede hacer referencia a varias carpetas de buzones y solo a una carpeta compartida.

Nota:

Debe usar la versión 1.3 o posterior del esquema de manifiesto de agente declarativo para agregar Email conocimiento.

{
  "capabilities": [
    {
      "name": "Email",
      "shared_mailbox": "sample@service.microsoft.com",
      "folders": [
        {
          "folder_id": "inbox"
        }
      ]
    }
  ]
}

En el campo folder_id , puede hacer referencia a nombres de carpeta conocidos o a identificadores de carpeta. Para obtener una lista de nombres de carpeta conocidos, consulte Tipo de recurso mailFolder. Para obtener una lista de identificadores de carpeta, use la siguiente consulta en el Probador de Graph:

https://graph.microsoft.com/v1.0/me/mailFolders

En el campo shared_mailbox , use la dirección SMTP del buzón compartido.

En el campo group_mailboxes , especifique una array cadena de cadenas (hasta 25) que contenga las direcciones SMTP de los buzones compartidos o grupos de Microsoft 365 a los que quiere que se limite el agente.

Si hace referencia a un buzón compartido y a una carpeta, el agente limita las respuestas a la carpeta dentro del buzón compartido. Si solo hace referencia a una carpeta, el agente limita las respuestas al contenido de la carpeta dentro del buzón personal.

Si no hace referencia a un buzón compartido o a una carpeta, la búsqueda del agente no se limita a ninguna carpeta o buzón y devuelve resultados de todo el contenido del correo electrónico, en función de la consulta del usuario.

Contactos

Fundamenta a tu agente en los datos de People para ofrecer respuestas más personalizadas y con reconocimiento del contexto. Los datos de People combinan información pública sobre los individuos, como el nombre, el puesto, las aptitudes y las relaciones organizativas, con una vista personal de las conexiones del usuario, los colaboradores y la información relevante. Esta fuente de conocimiento permite a los agentes:

Busque perfiles de usuarios y compañeros, incluida la estructura jerárquica y los detalles de contacto.
Identifique expertos en el dominio y colaboradores clave dentro de la organización.
Personalice las respuestas en función de las relaciones, interacciones pasadas y preferencias del usuario.
Ofrece recomendaciones y consejos de comunicación adaptados a equipos o individuos específicos.

Agregar origen de conocimiento de personas

Si usa Copilot Studio para crear su agente, el origen de conocimiento de People está habilitado de forma predeterminada para los usuarios con una licencia de Microsoft 365 Copilot.

Si usa Agents Toolkit y Visual Studio Code para crear el agente, agregue el valor a la propiedad capabilities en el archivo de manifiesto del agente para habilitar el conocimiento de People las personas, como se muestra en el ejemplo siguiente. Declarar solo la funcionalidad base People permite al agente razonar solo sobre los datos básicos de la organización, como los disponibles en la tarjeta de perfil. Para incluir contenido como mensajes, correos electrónicos y archivos de equipos relacionados entre el usuario agente y las personas a las que se hace referencia en la organización, consulte la versión 1.6 para usar la include_related_content propiedad.

Nota:

Para agregar el origen de conocimiento (sin contenido relacionado), utilice la Peopleversión 1.3 o posterior del esquema de manifiesto de agente declarativo. Para utilizar la propiedad, use la include_related_contentversión 1.6 o posterior.

{
  "capabilities": [
    {
      "name":"People"
    }
  ]
}

Si el agente necesita razonar sobre el contenido relacionado (entre el usuario del agente y las personas a las que se hace referencia), como mensajes, correos electrónicos y archivos relacionados con los equipos, aproveche la include_related_content propiedad. El valor predeterminado es false.

{
  "capabilities": [
    {
      "name":"People",
      "include_related_content": true
    }
  ]
}

Páginas de OneNote

Cuando use Microsoft 365 Copilot para crear su agente, puede elegir páginas específicas de OneNote en el selector de archivos para cargarlas como conocimiento. Solo puede seleccionar páginas individuales de OneNote. La opción de seleccionar un bloc de notas de OneNote completo no está disponible.

Usa el selector de archivos para agregar páginas de OneNote. Agent Builder no permite escribir direcciones URL de páginas de OneNote.

Mensajes de Teams

Puede configurar agentes para que usen canales, chats de reunión, chats grupales y chats individuales de Teams como orígenes de conocimiento. Puede elegir especificar hasta cinco vínculos a canales, grupos, 1:1 o chats de reunión para definir el ámbito de la búsqueda de Copilot, o puede permitir que el agente use el contenido de Teams del usuario, incluidos canales, reuniones y chats individuales y grupales, como orígenes de conocimiento.

Los agentes pueden devolver vínculos a archivos compartidos en mensajes de Teams, pero no pueden devolver vínculos a archivos almacenados en un canal de Teams, a menos que el agente también lo haya OneDriveAndSharePoint habilitado. Para obtener información sobre cómo optimizar el contenido de SharePoint para Copilot, vea Optimizar la recuperación de contenido.

Agregar mensajes de Teams orígenes de conocimiento

Si está utilizando Agent Builder para crear su agente, en la pestaña Configurar , en la sección Conocimiento , seleccione la barra de búsqueda y elija Mis chats y reuniones de Teams. Para limitar el ámbito del agente a chats específicos , de canal, de reunión o de grupo, en la pestaña Chats, seleccione los chats que desea agregar como conocimiento.

Si usa Agents Toolkit y Visual Studio Code para crear su agente, para habilitar el conocimiento de los mensajes de Teams, agregue el valor a la propiedad capabilities en la referencia del TeamsMessage manifiesto. Si desea limitar el ámbito del conocimiento de Teams a un máximo de cinco recursos de Teams, agregue los vínculos a la propiedad URLS , como se muestra en el ejemplo siguiente.

Nota:

Debe usar la versión 1.3 o posterior del esquema de manifiesto de agente declarativo para agregar el TeamsMessage origen de conocimiento.

{
  "capabilities": [
    {
      "name": "TeamsMessages",
      "urls": []
    }
  ]
}

Obtener la dirección URL de un canal o reunión

Para obtener la dirección URL de un canal de Teams, elija los tres puntos (...) junto al nombre del canal y elija Obtener vínculo al canal.

Para obtener la dirección URL de una reunión de Teams, ábrala, elija la flecha situada junto a Unirse y elija Copiar vínculo para unirse.

Obtener la dirección URL de un grupo o chat 1:1

Para obtener la dirección URL de un grupo o chat 1:1, necesita un vínculo profundo que incluya el chatId. El vínculo profundo tiene el siguiente formato: https://teams.microsoft.com/l/chat/<chatId>/conversations. El valor de chatId es diferente para cada chat.

Para obtener el valor de chatId de un grupo o chat 1:1:

En Microsoft Teams, vaya a cualquier mensaje del chat.
Pasa el ratón por encima del mensaje y elige los tres puntos (...).
Seleccione Copiar vínculo.
Pegue el vínculo en el Bloc de notas o en una aplicación similar. El vínculo tiene un aspecto similar al siguiente: https://teams.microsoft.com/l/chat/19:12ab3c4d-a123-12a3-a123-123ab12c12de_12a3bcd4-1234-1234-123a-1b2345c678d9@unq.gbl.spaces//1743033793614?context=%7B%22contextType%22%3A%22chat%22%7D.
Copie el segmento de la dirección URL que se encuentra entre chat/ el siguiente archivo y el /siguiente. El segmento suele estar precedido por 19:. Este es el chatId. En el ejemplo anterior, chatId es 19:12ab3c4d-a123-12a3-a123-123ab12c12de_12a3bcd4-1234-1234-123a-1b2345c678d9@unq.gbl.spaces.
Agregue el chatId al vínculo profundo. Por ejemplo: https://teams.microsoft.com/l/chat/19:12ab3c4d-a123-12a3-a123-123ab12c12de_12a3bcd4-1234-1234-123a-1b2345c678d9@unq.gbl.spaces/conversations.

Para obtener más información, consulte Vínculo profundo al chat de Teams.

Reuniones de Teams

Con el conocimiento de las reuniones de Teams, puede limitar el ámbito del agente para responder preguntas sobre reuniones, incluidas reuniones únicas o series de reuniones. Por ejemplo, el agente puede responder a consultas como "Resume las reuniones de ayer y enumera los elementos de acción" o "¿Qué se dijo sobre el proyecto X en mis reuniones?". Opcionalmente, puede limitar el ámbito de esta fuente de conocimiento a un máximo de cinco reuniones específicas. Esta fuente de conocimiento proporciona al agente acceso a los metadatos de la reunión (asunto, organizador, asistentes y título), al contenido de la transcripción y a los chats de la reunión.

Nota:

Hacer referencia a una serie de reuniones se limita a las últimas cuatro instancias de la serie.

Agregar el origen de conocimiento de las reuniones

Si está utilizando Agent Builder para crear su agente, en la pestaña Configurar , en la sección Conocimiento , seleccione la barra de búsqueda y elija Mis chats y reuniones de Teams. La capacidad de limitar el ámbito de las reuniones estará disponible próximamente en Agent Builder.

Si usa Agents Toolkit y Visual Studio Code para crear el agente, para habilitar el conocimiento de las reuniones, agregue el valor a la propiedad capabilities en el archivo de manifiesto del Meetings agente, como se muestra en el ejemplo siguiente. Si desea limitar el ámbito del agente a reuniones específicas, agregue el UID de la reunión a la items_by_id propiedad. Para obtener instrucciones sobre cómo buscar el identificador de una reunión, consulte Obtener el identificador de una reunión.

Nota:

Debe usar la versión 1.6 o posterior del esquema de manifiesto de agente declarativo para agregar el Meetings origen de conocimiento.

{
  "capabilities": [
    {
      "name":"Meetings",
      "items_by_id": [
        {
          "id": "010000002300A00045B6C7890D12E0030000000040056F7GH890IJ01000000000000000020000000J3L45M6A7NO8PQ9R0S12TUV340XY5Z00",
          "is_series": true
        }
      ]
    }
  ]
}

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2026-09-30

Agregar orígenes de conocimiento al agente declarativo

Conectores de Copilot

SharePoint y OneDrive

Búsqueda web y de ámbito web

Agregar búsqueda web y ámbito web

Fundamentación de búsqueda web y contenido dinámico

Contenido del archivo incrustado

Dataverse

Agregar conocimientos de Dataverse

Obtener un valor de aptitud preexistente o crear uno nuevo

Correo electrónico

Agregar orígenes de conocimiento de correo electrónico

Contactos

Agregar origen de conocimiento de personas

Páginas de OneNote

Mensajes de Teams

Agregar mensajes de Teams orígenes de conocimiento

Obtener la dirección URL de un canal o reunión

Obtener la dirección URL de un grupo o chat 1:1

Reuniones de Teams

Agregar el origen de conocimiento de las reuniones

Contenido relacionado

Comentarios

Recursos adicionales