Adicionar origens de conhecimento a um agente declarativo criado com o Toolkit de Agentes do Microsoft 365

Pode controlar os conhecimentos disponíveis para o seu agente para gerar respostas com origens de conhecimento da Web e os seus dados organizacionais do Microsoft 365. Para obter uma lista completa das origens de conhecimento disponíveis, veja Adicionar origens de conhecimento ao seu agente declarativo.

Adicionar pesquisa na Web ao agente

Adicionar pesquisa na Web ao agente permite-lhe procurar na Web para gerar respostas. Opcionalmente, pode definir o âmbito do conhecimento para sites específicos.

1. Abra o appPackage/declarativeAgent.json ficheiro e adicione a capabilities matriz com o seguinte conteúdo.

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

Para obter mais informações, veja Objeto de pesquisa na Web.

1. Selecione Aprovisionar no painel Ciclo de Vida do Toolkit de Agentes.

O agente declarativo terá acesso ao conteúdo Web para gerar as respetivas respostas depois de recarregar a página.

Adicionar um site do SharePoint ao agente

Pode adicionar ficheiros no OneDrive ou os conteúdos dos sites do SharePoint como uma origem de conhecimento.

1. Abra o appPackage/declarativeAgent.json ficheiro e adicione o seguinte valor à capabilities matriz, substituindo https://contoso.sharepoint.com/sites/ProductSupport por um URL de site do SharePoint na sua organização do Microsoft 365.

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

   Para obter mais informações, consulte OneDrive e objeto do SharePoint.

   Observação

   • Os URLs devem ser o caminho completo para itens do SharePoint (site, biblioteca de documentos, pasta ou ficheiro). Pode utilizar a opção "Copiar ligação direta" no SharePoint para obter o caminho completo ou ficheiros e pastas. Clique com o botão direito do rato no ficheiro ou pasta e selecione Detalhes. Navegue para Caminho e selecione o ícone de cópia.
   • Não especificar a items_by_url matriz (ou a matriz alternativa items_by_sharepoint_ids ) faz com que todos os conteúdos do OneDrive e do SharePoint na sua organização do Microsoft 365 que estejam disponíveis para o utilizador com sessão iniciada estejam disponíveis para o agente.

2. Selecione Aprovisionar no painel Ciclo de Vida do Toolkit de Agentes.

O agente declarativo terá acesso aos conteúdos do OneDrive e do SharePoint para gerar as respetivas respostas depois de recarregar a página.

Adicionar mensagens do Teams ao agente

1. Abra o appPackage/declarativeAgent.json ficheiro e adicione o seguinte valor à capabilities matriz, substituindo https://teams.microsoft.com/l/team/... por um canal do Teams ou url de equipa da sua organização.

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

   Para obter mais informações, consulte Objeto de mensagens do Microsoft Teams.

   Observação

   • O URL no objeto url tem de ter ligações bem formadas para uma conversa, equipa ou conversa de reunião do Teams.
   • Não especificar a urls matriz faz com que todos os canais, equipas, reuniões, chats 1:1 e chats de grupo do Teams na sua organização do Microsoft 365 que estejam disponíveis para o utilizador com sessão iniciada estejam disponíveis para o agente.

2. Selecione Aprovisionar no painel Ciclo de Vida do Toolkit de Agentes.

O agente declarativo terá acesso aos dados do Teams para gerar as respetivas respostas depois de recarregar a página.

Adicionar conhecimentos de pessoas ao agente

A origem de conhecimento pessoas permite-lhe definir o âmbito do seu agente para responder a perguntas sobre indivíduos numa organização.

1. Abra o appPackage/declarativeAgent.json ficheiro e adicione a People entrada à capabilities matriz.

   {
     "name": "People"
   }
   

Para obter mais informações, veja Pessoas objeto.

1. Selecione Aprovisionar no painel Ciclo de Vida do Toolkit de Agentes.

O agente declarativo terá acesso ao conhecimento das pessoas depois de recarregar a página.

Adicionar mensagens de e-mail ao agente

A origem de conhecimento de e-mail permite-lhe definir o âmbito do seu agente para utilizar o e-mail da caixa de correio do utilizador ou de uma caixa de correio partilhada para responder a consultas.

1. Abra o appPackage/declarativeAgent.json ficheiro e adicione a Email entrada à capabilities matriz.

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

   Para obter mais informações, veja Email objeto.

   Observação

   • Este exemplo acede ao utilizador da caixa de correio do agente. Para aceder a uma caixa de correio partilhada, adicione a propriedade opcional shared_mailbox definida ao endereço de e-mail da caixa de correio partilhada.
   • A folders matriz limita o acesso da caixa de correio a pastas específicas. Para aceder a toda a caixa de correio, omita a folders matriz.

2. Selecione Aprovisionar no painel Ciclo de Vida do Toolkit de Agentes.

O agente declarativo terá acesso aos conhecimentos de e-mail depois de recarregar a página.

Adicionar um conector de Microsoft 365 Copilot ao agente

Adicionar um conector Copilot disponibiliza os itens ingeridos por esse conector ao agente como uma origem de dados de conhecimento.

1. Abra o appPackage/declarativeAgent.json ficheiro e adicione o seguinte valor à capabilities matriz, substituindo policieslocal por um ID de conector Copilot válido na sua organização do Microsoft 365. Para obter mais informações sobre como encontrar IDs do conector Copilot, veja Obter IDs de capacidades para o manifesto declarativo do agente.

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

   Para obter mais informações, veja Objeto de conectores Copilot.

   Observação

   • Não especificar a connections matriz faz com que todos os conteúdos dos conectores Copilot na sua organização do Microsoft 365 que estejam disponíveis para o utilizador com sessão iniciada estejam disponíveis para o agente.

2. Selecione Aprovisionar no painel Ciclo de Vida do Toolkit de Agentes.

O agente declarativo terá acesso ao conteúdo dos conectores Copilot para gerar as respetivas respostas depois de recarregar a página.

Próxima etapa