Adición de orígenes de conocimiento a un agente declarativo creado con microsoft 365 Agents Toolkit

Puede controlar los conocimientos disponibles para el agente para generar respuestas con orígenes de conocimiento de la web y los datos de la organización de Microsoft 365. Para obtener una lista completa de los orígenes de conocimiento disponibles, consulte Incorporación de orígenes de conocimiento al agente declarativo.

Adición de búsqueda web al agente

Agregar búsqueda web al agente le permite buscar en la web para generar respuestas. Opcionalmente, puede limitar los conocimientos a sitios web específicos.

1. Abra el appPackage/declarativeAgent.json archivo y agregue la capabilities matriz con el siguiente contenido.

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

Para obtener más información, vea Objeto de búsqueda web.

1. Seleccione Aprovisionar en el panel Ciclo de vida del kit de herramientas de agentes.

El agente declarativo tendrá acceso al contenido web para generar sus respuestas después de volver a cargar la página.

Agregar un sitio de SharePoint al agente

Puede agregar archivos en OneDrive o el contenido de sitios de SharePoint como origen de conocimiento.

1. Abra el appPackage/declarativeAgent.json archivo y agregue el siguiente valor a la capabilities matriz, reemplazando https://contoso.sharepoint.com/sites/ProductSupport por una dirección URL de sitio de SharePoint en su organización de Microsoft 365.

   {
     "name": "OneDriveAndSharePoint",
     "items_by_url": [
       {
         "url": "https://contoso.sharepoint.com/sites/ProductSupport"
       }
     ]
   }
   

   Para obtener más información, vea OneDrive y objeto de SharePoint.

   Nota:

   • Las direcciones URL deben ser ruta de acceso completa a elementos de SharePoint (sitio, biblioteca de documentos, carpeta o archivo). Puede usar la opción "Copiar vínculo directo" en SharePoint para obtener la ruta de acceso completa o los archivos y carpetas. Haga clic con el botón derecho en el archivo o carpeta y seleccione Detalles. Vaya a Ruta de acceso y seleccione el icono de copia.
   • No especificar la items_by_url matriz (o la matriz alternativa items_by_sharepoint_ids ) hace que todo el contenido de OneDrive y SharePoint de la organización de Microsoft 365 que está disponible para el usuario que ha iniciado sesión esté disponible para el agente.

2. Seleccione Aprovisionar en el panel Ciclo de vida del kit de herramientas de agentes.

El agente declarativo tendrá acceso al contenido de OneDrive y SharePoint para generar sus respuestas después de volver a cargar la página.

Agregar mensajes de Teams al agente

1. Abra el appPackage/declarativeAgent.json archivo y agregue el siguiente valor a la capabilities matriz, reemplazando https://teams.microsoft.com/l/team/... por un canal de Teams o una dirección URL de equipo de su organización.

   {
     "name": "TeamsMessages",
     "urls": [
       {
         "url": "https://teams.microsoft.com/l/team/..."
       }
     ]
   }
   

   Para obtener más información, vea Objeto de mensajes de Microsoft Teams.

   Nota:

   • La dirección URL del objeto url debe tener vínculos bien formados a un chat, equipo o chat de reunión de Teams.
   • Si no se especifica la urls matriz, todos los canales de Teams, los equipos, las reuniones, el chat 1:1 y los chats de grupo de la organización de Microsoft 365 que están disponibles para el usuario que ha iniciado sesión estarán disponibles para el agente.

2. Seleccione Aprovisionar en el panel Ciclo de vida del kit de herramientas de agentes.

El agente declarativo tendrá acceso a los datos de Teams para generar sus respuestas después de volver a cargar la página.

Adición de conocimientos de personas al agente

El origen de conocimiento de personas le permite limitar el agente para responder a preguntas sobre los usuarios de una organización.

1. Abra el appPackage/declarativeAgent.json archivo y agregue la People entrada a la capabilities matriz.

   {
     "name": "People"
   }
   

Para obtener más información, vea Personas objeto.

1. Seleccione Aprovisionar en el panel Ciclo de vida del kit de herramientas de agentes.

El agente declarativo tendrá acceso a los conocimientos de las personas después de volver a cargar la página.

Adición de mensajes de correo electrónico al agente

El origen de conocimiento de correo electrónico le permite limitar el agente para usar el correo electrónico del buzón del usuario o un buzón compartido para responder a las consultas.

1. Abra el appPackage/declarativeAgent.json archivo y agregue la Email entrada a la capabilities matriz.

   {
     "name": "Email",
     "folders": [
       {
         "folder_id": "inbox"
       }
     ]
   }
   

   Para obtener más información, vea Email objeto .

   Nota:

   • En este ejemplo se accede al usuario del buzón del agente. Para acceder a un buzón compartido en su lugar, agregue la propiedad opcional shared_mailbox establecida en la dirección de correo electrónico del buzón compartido.
   • La folders matriz limita el acceso del buzón a carpetas específicas. Para acceder a todo el buzón de correo, omita la folders matriz.

2. Seleccione Aprovisionar en el panel Ciclo de vida del kit de herramientas de agentes.

El agente declarativo tendrá acceso a los conocimientos de correo electrónico después de volver a cargar la página.

Adición de un conector de Microsoft 365 Copilot al agente

Al agregar un conector copilot, los elementos ingeridos por ese conector están disponibles para el agente como origen de conocimiento.

1. Abra el appPackage/declarativeAgent.json archivo y agregue el siguiente valor a la capabilities matriz, reemplazando policieslocal por un identificador de conector de Copilot válido en la organización de Microsoft 365. Para obtener más información sobre cómo buscar identificadores de conector de Copilot, consulte Recuperación de identificadores de funcionalidades para el manifiesto de agente declarativo.

   {
     "name": "GraphConnectors",
     "connections": [
       {
         "connection_id": "policieslocal"
       }
     ]
   }
   

   Para obtener más información, vea Copilot connectors object (Objeto de conectores de Copilot).

   Nota:

   • Si no se especifica la matriz, todo el connections contenido de los conectores de Copilot de la organización de Microsoft 365 que está disponible para el usuario que ha iniciado sesión estará disponible para el agente.

2. Seleccione Aprovisionar en el panel Ciclo de vida del kit de herramientas de agentes.

El agente declarativo tendrá acceso al contenido de los conectores de Copilot para generar sus respuestas después de volver a cargar la página.

Paso siguiente