Adicionar fontes de conhecimento a um agente declarativo criado com o Microsoft 365 Agents Toolkit

Você pode controlar o conhecimento disponível para seu agente para gerar respostas com fontes de conhecimento da Web e seus dados organizacionais do Microsoft 365. Para obter uma lista completa das fontes de conhecimento disponíveis, consulte Adicionar fontes de conhecimento ao seu agente declarativo.

Adicionar pesquisa na Web ao agente

Adicionar uma pesquisa na Web ao seu agente permite que ele pesquise na Web para gerar respostas. Opcionalmente, você pode definir o escopo do conhecimento para sites específicos.

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

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

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

1. Selecione Provisionar no painel Ciclo de Vida do Kit de Ferramentas para Agentes.

O agente declarativo terá acesso ao conteúdo da Web para gerar suas respostas depois que você recarregar a página.

Adicionar um site do SharePoint ao agente

Você pode adicionar arquivos no OneDrive ou o conteúdo de sites do SharePoint como uma fonte de conhecimento.

1. Abra o appPackage/declarativeAgent.json arquivo e adicione o valor a seguir à capabilities matriz, substituindo https://contoso.sharepoint.com/sites/ProductSupport por uma URL do site do SharePoint em sua organização do Microsoft 365.

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

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

   Observação

   • As URLs devem ser o caminho completo para itens do SharePoint (site, biblioteca de documentos, pasta ou arquivo). Você pode usar a opção "Copiar link direto" no SharePoint para obter o caminho completo ou arquivos e pastas. Clique com o botão direito do mouse no arquivo ou na pasta e selecione Detalhes. Navegue até Caminho e selecione o ícone de cópia.
   • Não especificar a matriz (ou a matriz alternativaitems_by_sharepoint_ids) faz com que todo o items_by_url conteúdo do OneDrive e do SharePoint em sua organização do Microsoft 365 que está disponível para o usuário conectado esteja disponível para o agente.

2. Selecione Provisionar no painel Ciclo de Vida do Kit de Ferramentas para Agentes.

O agente declarativo terá acesso ao conteúdo do OneDrive e do SharePoint para gerar suas respostas depois que você recarregar a página.

Adicionar mensagens do Teams ao agente

1. Abra o appPackage/declarativeAgent.json arquivo e adicione o seguinte valor à capabilities matriz, substituindo https://teams.microsoft.com/l/team/... por um canal do Teams ou URL da equipe 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

   • A url no objeto url devem conter links bem formados para um chat do Teams, uma equipe ou um chat de reunião.
   • Não especificar a urls matriz faz com que todos os canais, equipes, reuniões, chat 1:1 e chats em grupo do Teams em sua organização do Microsoft 365 que está disponível para o usuário conectado estejam disponíveis para o agente.

2. Selecione Provisionar no painel Ciclo de Vida do Kit de Ferramentas para Agentes.

O agente declarativo terá acesso aos dados do Teams para gerar suas respostas depois que você recarregar a página.

Adicione conhecimento pessoal ao agente

A fonte de conhecimento de pessoas permite que você defina o escopo de seu agente para responder a perguntas sobre indivíduos em uma organização.

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

   {
     "name": "People"
   }
   

Para obter mais informações, consulte o objeto People.

1. Selecione Provisionar no painel Ciclo de Vida do Kit de Ferramentas para Agentes.

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

Adicionar mensagens de email ao agente

A fonte de conhecimento de email permite que você defina o escopo do seu agente para usar o email da caixa de correio do usuário ou de uma caixa de correio compartilhada para responder a consultas.

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

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

   Para obter mais informações, consulte Objeto de Email.

   Observação

   • Este exemplo acessa o usuário da caixa de correio do agente. Para acessar uma caixa de correio compartilhada, adicione a propriedade opcional shared_mailbox definida ao endereço de email da caixa de correio compartilhada.
   • A folders matriz limita o acesso da caixa de correio a pastas específicas. Para acessar a caixa de correio inteira, omita a folders matriz.

2. Selecione Provisionar no painel Ciclo de Vida do Kit de Ferramentas para Agentes.

O agente declarativo terá acesso ao conhecimento de email depois que você recarregar a página.

Adicionar um conector do Microsoft 365 Copilot ao agente

Adicionar um conector Copilot torna os itens ingeridos por esse conector disponíveis para o agente como uma fonte de conhecimento.

1. Abra o appPackage/declarativeAgent.json arquivo e adicione o valor a seguir à capabilities matriz, substituindo-o policieslocal por uma ID válida do conector Copilot na sua organização do Microsoft 365. Para obter mais informações sobre como encontrar IDs de conector do Copilot, consulte Recuperando IDs de recursos para manifesto de agente declarativo.

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

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

   Observação

   • Não especificar a matriz faz com que todo o connections conteúdo dos conectores do Copilot em sua organização do Microsoft 365 que está disponível para o usuário conectado esteja disponível para o agente.

2. Selecione Provisionar no painel Ciclo de Vida do Kit de Ferramentas para Agentes.

O agente declarativo terá acesso ao conteúdo dos conectores do Copilot para gerar suas respostas depois que você recarregar a página.

Próxima etapa