Compartir a través de

Adición de orígenes de conocimiento al agente declarativo

Para mejorar la experiencia del usuario del agente declarativo, agregue funcionalidades como el intérprete de código y el generador de imágenes y los orígenes de conocimiento para mejorar y personalizar el conocimiento del agente. El objeto capabilities de la referencia de manifiesto y la sección Conocimiento del generador de agentes de Copilot Studio 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 tabla siguiente se enumeran las funcionalidades y orígenes de conocimiento que puede configurar mediante el generador de agentes o microsoft 365 Agents Toolkit (una evolución del kit de herramientas de Teams) e indica si los usuarios necesitan una licencia de Microsoft 365 Copilot o un uso medido para acceder a los agentes con esa funcionalidad o origen de conocimiento.

Funcionalidad o origen de conocimiento Generador de agentes 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 de archivo incrustado ✅ ❌ Sí
Búsqueda web ✅ ✅ No
Búsqueda web con ámbito ✅ ✅ No
Dataverse ❌ ✅* Sí
Correo electrónico ✅ ✅* Sí (solo licencia)
Contactos ❌ ✅ Sí (solo licencia)
Mensajes de Teams ✅ ✅* Sí (solo licencia)

* La opción de limitar el conocimiento está disponible.

Conectores de Copilot

Microsoft 365 Copilot conectores (anteriormente conectores de Microsoft Graph) permiten agregar datos de la organización al agente como información de conexión a tierra. Puede usar los conectores de Copilot para ingerir los datos de línea de negocio en Microsoft Graph y Copilot puede razonar sobre los datos como información de puesta a tierra en respuestas a las solicitudes del usuario. 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 copilot como conocimiento al manifiesto del agente en Agents Toolkit, consulte Copilot connectors object (Objeto de conectores de Copilot).

Para obtener información sobre cómo agregar conectores copilot al agente en Copilot Studio generador de agentes, consulte Conectores de Copilot.

SharePoint y OneDrive

Al configurar el agente para que use el contenido de OneDrive y SharePoint como conocimiento, Copilot busca archivos, carpetas o sitios de SharePoint y OneDrive a los que un usuario tiene acceso para obtener información de puesta a tierra.

Para obtener información sobre cómo agregar conocimientos de OneDrive y SharePoint al manifiesto del agente en agents Toolkit, vea OneDrive y el objeto de SharePoint.

Para obtener información sobre cómo agregar conocimientos de SharePoint al agente en Copilot Studio generador de agentes, vea Agregar orígenes de conocimiento.

La búsqueda web permite a los agentes usar el índice de búsqueda en Bing para responder a las solicitudes del usuario. Si habilita la búsqueda web en el agente, puede hacer que el agente devuelva cualquier dato web en sus respuestas. También puede limitar la búsqueda web a hasta cuatro sitios web públicos.

Si usa agents Toolkit y Visual Studio Code para crear el agente, para habilitar la búsqueda web, agregue el WebSearch valor a la propiedad capabilities en el archivo de manifiesto. Si desea limitar 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:

Debe usar la versión 1.2 o posterior del esquema de manifiesto del agente declarativo para agregar la búsqueda web con ámbito al agente.

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

Si usa Copilot Studio generador de agentes para crear el agente, en la pestaña Configurar, en Conocimiento, muestre las direcciones URL del sitio web a las que desea hacer referencia.

Contenido de archivo incrustado

Si usa Copilot Studio generador de agentes para compilar el agente, puede cargar archivos directamente desde el dispositivo o la nube para insertar el contenido para que el agente lo use como conocimiento. El contenido del archivo incrustado se almacena en SharePoint Embedded. Estos archivos cuentan con la capacidad de OneDrive y SharePoint en el inquilino.

Nota:

La característica de carga de archivos está disponible para los usuarios con consumo medido habilitado o con una licencia de Microsoft 365 Copilot.

Para obtener más información sobre los archivos incrustados, vea Contenido de archivos incrustados en el generador de agentes.

Dataverse

El conocimiento de Dataverse permite a los agentes responder en lenguaje natural a las consultas del usuario sobre sus datos de CRM o datos de tablas de 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 de las tablas. Para obtener más información, vea Agregar un origen de conocimiento de dataverse.

Nota:

El conocimiento de Dataverse no está disponible actualmente en Copilot Studio generador de agentes.

Incorporación de conocimientos de Dataverse

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

Nota:

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

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

Correo electrónico

Email conocimiento le permite limitar el 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 usa Copilot Studio generador de agentes para crear el agente, en la pestaña Configurar de la sección Conocimiento, elija Mis correos electrónicos.

Nota:

Actualmente no puede limitar los correos electrónicos a una carpeta específica o un buzón compartido cuando se usa el generador de agentes.

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

Nota:

Debe usar la versión 1.3 o posterior del esquema de manifiesto del 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 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 Explorador de Graph:

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

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

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 una carpeta, la búsqueda del agente no tiene como ámbito ninguna carpeta o buzón y devuelve los resultados de todo el contenido del correo electrónico, en función de la consulta del usuario.

Contactos

Personas conocimiento le permite definir el ámbito del agente para responder a preguntas sobre las personas de una organización. Por ejemplo, el agente puede responder a consultas como "Cómo persona> de contacto<" o "Enumerar los informes directos de <la persona>". Este origen de conocimiento no tiene ámbito.

Nota:

Personas conocimiento no está disponible actualmente en Copilot Studio generador de agentes.

Incorporación de un origen de conocimiento de personas

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

Nota:

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

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

Mensajes de Teams

Puede configurar agentes para usar canales de Teams, chats de reuniones, chats de grupo y chats 1:1 como orígenes de conocimiento. Puede elegir especificar hasta cinco vínculos a canales, grupos, 1:1 o chats de reuniones para limitar la búsqueda de Copilot, o puede permitir que el agente use todo el contenido de Teams del usuario, incluidos canales, reuniones y chats individuales y grupales, como fuentes 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 se haya OneDriveAndSharePoint habilitado. Para obtener información sobre cómo optimizar el contenido de SharePoint para Copilot, vea Optimizar la recuperación de contenido de SharePoint.

Agregar orígenes de conocimiento de mensajes de Teams

Si usa Copilot Studio generador de agentes para crear el agente, en la pestaña Configurar, en la sección Conocimiento, seleccione la barra de búsqueda y elija Mis chats de Teams de grupos, canales y reuniones. Para limitar el agente a chats específicos de canal, reunión o grupo, en la pestaña Chats, seleccione los chats que desea agregar como conocimiento.

Si usa agents Toolkit y Visual Studio Code para crear el agente, para habilitar el conocimiento de mensajes de Teams, agregue el TeamsMessage valor a la propiedad capabilities en la referencia del manifiesto. Si desea limitar los conocimientos de Teams a hasta 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 del agente declarativo para agregar el origen de TeamsMessage 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, abra la reunión, elija la flecha situada junto a Unirse y elija Copiar vínculo de combinación.

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 formato siguiente: https://teams.microsoft.com/l/chat/<chatId>/conversations. El valor de chatId es diferente para cada chat.

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

  1. En Microsoft Teams, vaya a cualquier mensaje del chat.
  2. Mantenga el puntero sobre el mensaje y elija los tres puntos (...).
  3. Seleccione Copiar vínculo.
  4. Pegue el vínculo en el Bloc de notas o en una aplicación similar. El vínculo tendrá un aspecto similar a la siguiente dirección URL: 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.
  5. Copie el segmento de la dirección URL que se encuentra entre chat/ y el siguiente /. Por lo general, el segmento está precedido de 19:. Este es el chatId. En el ejemplo anterior, el valor de chatId es 19:12ab3c4d-a123-12a3-a123-123ab12c12de_12a3bcd4-1234-1234-123a-1b2345c678d9@unq.gbl.spaces.
  6. 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.

Contenido relacionado