Adicionar fontes de conhecimento ao seu agente declarativo

Você pode aprimorar a experiência do usuário de seu agente declarativo adicionando recursos como interpretador de código e gerador de imagens e fontes de conhecimento para aprimorar e personalizar o conhecimento de seu agente. O objeto capabilities na referência de manifesto e a seção Conhecimento no Microsoft 365 Copilot fornecem várias opções para você desbloquear recursos para seus usuários. Este artigo descreve as fontes de conhecimento que você pode adicionar aos seus agentes.

A tabela a seguir lista os recursos e fontes de conhecimento que você pode configurar usando o Agent Builder no Microsoft 365 Copilot ou no Microsoft 365 Agents Toolkit e indica se os usuários precisam de uma licença do Microsoft 365 Copilot ou uso limitado para acessar agentes com esse recurso ou fonte de conhecimento.

* A opção para definir o escopo do conhecimento está disponível.

Conectores do Copilot

Os conectores do Microsoft 365 Copilot permitem que você adicione dados organizacionais ao seu agente como informações básicas. Use conectores do Copilot para ingerir seus dados de linha de negócios no Microsoft Graph para que o Copilot possa raciocinar sobre seus dados como informações básicas em respostas às solicitações do usuário. Para saber mais, confira a Visão geral dos conectores do Microsoft 365 Copilot.

Para obter informações sobre como adicionar conectores do Copilot como conhecimento ao manifesto do agente no Agents Toolkit, consulte Objeto de conectores do Copilot.

Para obter informações sobre como adicionar conectores do Copilot ao seu agente no Agent Builder, consulte Conectores do Copilot.

SharePoint e OneDrive

Quando você configura seu agente para usar o conteúdo do SharePoint e do OneDrive como conhecimento, o Copilot pesquisa arquivos, pastas ou sites do SharePoint e do OneDrive aos quais um usuário tem acesso para obter informações básicas.

Para obter informações sobre como adicionar conhecimento do SharePoint e do OneDrive ao manifesto do agente no Kit de Ferramentas de Agentes, consulte Objeto do OneDrive e do SharePoint.

Para obter informações sobre como adicionar conhecimento do SharePoint e do OneDrive ao seu agente no Agent Builder — e para os limites por agente e como as permissões e os rótulos de confidencialidade são tratados — consulte o conteúdo do SharePoint e do OneDrive.

Pesquisa na Web com escopo e na Web

A pesquisa na Web permite que os agentes usem o índice de pesquisa no Bing para responder às solicitações do usuário. Se você habilitar a pesquisa na Web em seu agente, ele poderá retornar quaisquer dados da Web em suas respostas. Você também pode definir o escopo da pesquisa na Web para até quatro sites públicos.

Adicionar pesquisa na Web com escopo e na Web com escopo

Se você estiver usando o Agents Toolkit e o Visual Studio Code para criar seu agente, adicione o valor à propriedade capabilities em seu arquivo de manifesto para habilitar a WebSearch pesquisa na Web. Para definir o escopo de sua pesquisa na Web para sites específicos, adicione a propriedade sites e especifique até quatro URLs, conforme mostrado no exemplo a seguir.

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

Se você estiver usando o Agent Builder para criar seu agente, na guia Configurar , em Knowledge, liste os URLs do site que deseja referenciar.

Base de pesquisa na Web e conteúdo dinâmico

Quando o manifesto de um agente declarativo define o escopo da pesquisa na Web para URLs de sites específicos, o agente baseia suas respostas no conteúdo que o Bing indexa para esses sites, em vez de no acesso direto à fonte de dados subjacente.

A pesquisa na Web com escopo depende do conteúdo indexado pelo Bing para os sites configurados. Como resultado, o conteúdo que depende da renderização do lado do cliente ou de dados gerados dinamicamente pode não estar totalmente representado nos resultados da pesquisa. Em alguns casos, o conteúdo carregado dinamicamente pode estar ausente ou desatualizado em relação ao que aparece no site ativo.

Esse comportamento pode produzir resultados inconsistentes. O conteúdo mostrado em um site pode ser diferente do conteúdo disponível para o agente, e o agente pode não retornar de forma confiável os itens mais recentes de listas geradas dinamicamente ou atualizadas com frequência.

Esse comportamento é esperado com a arquitetura de agente declarativo atual. Os agentes declarativos não se destinam a fontes da Web geradas dinamicamente ou não OpenAPI, e esses cenários podem levar a resultados de aterramento incompletos ou inconsistentes.

Para acessar conteúdo estruturado e alterado com frequência diretamente, use um plug-in de API apoiado por uma especificação OpenAPI em vez de pesquisa na web com escopo. Um plug-in de API permite que o agente consulte a fonte de dados subjacente diretamente e use parâmetros de API, como classificação e limites de resultado, em vez de depender de conteúdo da Web indexado. Como alternativa, migre o conteúdo para uma fonte de conhecimento estática ou baseada em OpenAPI com suporte. Para obter orientação sobre essas abordagens, consulte:

• Escreva instruções eficazes para agentes declarativos com plug-ins de API
• Adicionar um plug-in de API a um agente declarativo usando uma API existente
• Diretrizes de documentos OpenAPI

Conteúdo de arquivo inserido

Se você estiver usando o Agent Builder para criar seu agente, poderá fazer upload de arquivos diretamente do seu dispositivo ou da nuvem para incorporar o conteúdo para o agente usar como conhecimento. O conteúdo do arquivo inserido é armazenado no SharePoint Embedded. Esses arquivos contam para a capacidade do OneDrive e do SharePoint em seu locatário.

Para obter mais informações sobre arquivos inseridos, consulte Conteúdo de arquivos inseridos.

Dataverse

O conhecimento do Dataverse permite que os agentes respondam em linguagem natural às consultas dos usuários sobre seus dados de CRM ou dados de tabelas no Microsoft Dataverse. Você pode adicionar uma instância do Dataverse como uma fonte de conhecimento e adicionar sinônimos e um glossário para ajudar o sistema a interpretar melhor os dados personalizados em suas tabelas. Para obter mais informações, consulte Adicionar uma fonte de conhecimento do Dataverse.

Adicionar conhecimento do Dataverse

Se você estiver usando o Agents Toolkit e o Visual Studio Code para criar seu agente, adicione o valor à propriedade no arquivo de manifesto capabilities do agente para habilitar o Dataverse conhecimento do Dataverse, conforme mostrado no exemplo a seguir.

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

Antes de adicionar essa habilidade, verifique se o skill valor na matriz de recursos existe no ambiente do Dataverse. Além disso, verifique se o valor corresponde à ID da host_name sua organização.

Buscar um valor de habilidade preexistente ou criar um novo

Para buscar ou criar um valor do Dataverse skill :

1. Obter a ID da sua organização no portal > do criador do Power AppsConfigurações>Recursos do desenvolvedor.

2. Obtenha um token de portador para autenticar e criar recursos do Dataverse. Para obter um token de portador, crie um novo registro de aplicativo no portal do Azure e execute a seguinte solicitação 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"
   

3. Determine se um skill valor já existe usando a seguinte solicitação curl. Se um skill valor já existir, a resposta conterá uma lista de habilidades existentes DVTableSearch em seu ambiente do 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"
   

   Response

   {
    "@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
      }
   ]
   }
   

   Se já existir um skill valor, use-o no arquivo de manifesto do agente. Se o skill valor não existir, a resposta conterá uma matriz vazia.

   Response

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

4. Se não skill existir, crie uma DVTableSearch habilidade e use o nome atribuído a ela.

   Solicitação

   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"
       }
     ]
   }'
   

   Response

   A solicitação retorna 204 No Content para indicar que a DVTableSearch habilidade foi criada com êxito.

   HTTP/1.1 204 No Content
   

5. Execute a solicitação curl na Etapa 3 novamente para marcar se há uma habilidade existenteDVTableSearch. A resposta contém o dvtablesearchid do arquivo .skill Você pode usar esse valor ou o valor na propriedade do arquivo de manifesto nameskill do agente.

Email

O conhecimento de Email permite que você defina o escopo de seu agente para uma caixa de correio pessoal ou compartilhada e, opcionalmente, uma pasta de caixa de correio específica.

Adicionar fontes de conhecimento de email

Se você estiver usando o Agent Builder para criar seu agente, na guia Configurar na seção Conhecimento , selecione Meus e-mails.

Se você estiver usando o Agents Toolkit e o Visual Studio Code para criar seu agente, para adicionar conhecimento de email, adicione o valor à propriedade capabilities no arquivo de manifesto Email do agente, conforme mostrado no exemplo a seguir. Você pode fazer referência a várias pastas de caixa de correio e a apenas uma pasta compartilhada.

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

No campo folder_id , você pode fazer referência a nomes ou IDs de pasta conhecidos. Para obter uma lista de nomes de pastas conhecidos, consulte tipo de recurso mailFolder. Para obter uma lista de IDs de pasta, use a seguinte consulta no Graph Explorer:

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

No campo shared_mailbox , use o endereço SMTP da caixa de correio compartilhada.

No campo group_mailboxes , você especifica uma array das cadeias de caracteres (até 25) que contém os endereços SMTP das caixas de correio compartilhadas ou dos grupos do Microsoft 365 para os quais você deseja que o agente tenha o escopo.

Se você fizer referência a uma caixa de correio compartilhada e a uma pasta, o agente define o escopo das respostas para a pasta dentro da caixa de correio compartilhada. Se você fizer referência apenas a uma pasta, o agente define o escopo das respostas para o conteúdo da pasta na caixa de correio pessoal.

Se você não fizer referência a uma caixa de correio ou pasta compartilhada, a pesquisa de agente não terá como escopo nenhuma pasta ou caixa de correio e retornará resultados de todo o conteúdo do email, com base na consulta do usuário.

Pessoas

Baseie seu agente nos dados do People para fornecer respostas mais personalizadas e com reconhecimento de contexto. O People data combina informações públicas sobre indivíduos, como nome, cargo, habilidades e relacionamentos organizacionais, com uma exibição pessoal das conexões do usuário, colaboradores e insights relevantes. Essa fonte de conhecimento permite que os agentes:

• Pesquise perfis de usuários e colegas, incluindo estrutura de relatórios e detalhes de contato.
• Identifique especialistas de domínio e colaboradores-chave dentro da organização.
• Personalize as respostas com base nos relacionamentos, interações anteriores e preferências do usuário.
• Forneça recomendações e dicas de comunicação adaptadas a equipes ou indivíduos específicos.

Adicionar fonte de conhecimento de pessoas

Se você usar o Copilot Studio para criar seu agente, a fonte de conhecimento do People será habilitada por padrão para usuários com uma licença do Microsoft 365 Copilot.

Se você usar o Agents Toolkit e o Visual Studio Code para criar seu agente, adicione o valor à propriedade capabilities no arquivo de manifesto People do agente para habilitar o conhecimento das pessoas, conforme mostrado no exemplo a seguir. Declarar apenas o recurso básico People permite que o agente raciocine apenas sobre os dados básicos da organização, como aqueles disponíveis no perfil card. Para incluir conteúdo, como mensagens, emails e arquivos de equipes relacionados entre o usuário agente e as pessoas referenciadas na organização, consulte a versão 1.6 para usar a include_related_content propriedade.

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

Se o seu agente precisar raciocinar sobre o conteúdo relacionado (entre o usuário do agente e as pessoas referenciadas), como mensagens, emails e arquivos de equipes relacionadas, aproveite a include_related_content propriedade. O valor padrão é false.

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

Páginas do OneNote

Ao usar o Microsoft 365 Copilot para criar seu agente, você pode escolher páginas específicas do OneNote no seletor de arquivos para carregar como conhecimento. Você só pode selecionar páginas individuais do OneNote. A opção de selecionar um bloco de anotações inteiro do OneNote não está disponível.

Use o seletor de arquivos para adicionar páginas do OneNote. O Agent Builder não oferece suporte à inserção de URLs de página do OneNote.

Mensagens do Teams

Você pode configurar agentes para usar canais do Teams, chats de reunião, chats em grupo e chats individuais como fontes de conhecimento. Você pode optar por especificar até cinco links para canais, grupos, chats individuais ou de reuniões para definir o escopo da pesquisa do Copilot ou pode permitir que seu agente use o conteúdo do Teams do usuário, incluindo canais, reuniões e chats individuais e em grupo, como fontes de conhecimento.

Os agentes podem retornar links para arquivos compartilhados em mensagens do Teams, mas não podem retornar links para arquivos armazenados em um canal do Teams, a menos que o agente também tenha OneDriveAndSharePoint habilitado. Para obter informações sobre como otimizar o conteúdo do SharePoint para o Copilot, consulte Otimizar a recuperação de conteúdo.

Adicionar mensagens do Teams fontes de conhecimento

Se você estiver usando o Agent Builder para criar seu agente, na guia Configurar , na seção Conhecimento , selecione a barra de pesquisa e escolha Meus chats e reuniões do Teams. Para definir o escopo de seu agente para canais, reuniões ou chats em grupo específicos, na guia Chats , selecione os chats que você deseja adicionar como conhecimento.

Se você estiver usando o Agents Toolkit e o Visual Studio Code para criar seu agente, para habilitar o conhecimento de mensagens do Teams, adicione o valor à propriedade capabilities em sua referência de manifestoTeamsMessage. Se você quiser ampliar o conhecimento do Teams para até cinco recursos do Teams, adicione os links à propriedade urls , conforme mostrado no exemplo a seguir.

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

Obter a URL de um canal ou reunião

Para obter a URL de um canal do Teams, escolha os três pontos (...) ao lado do nome do canal e escolha Obter link para o canal.

Para obter a URL de uma reunião do Teams, abra a reunião, escolha a seta ao lado de Ingressar e escolha Copiar link de ingresso.

Obter a URL para um grupo ou chat individual

Para obter a URL de um chat em grupo ou 1:1, você precisa de um link profundo que inclua a chatId. O link profundo tem o seguinte formato: https://teams.microsoft.com/l/chat/<chatId>/conversations. O valor chatId é diferente para cada chat.

Para obter o valor chatId para um grupo ou chat 1:1:

1. No Microsoft Teams, vá para qualquer mensagem no chat.
2. Passe o mouse sobre a mensagem e escolha os três pontos (...).
3. Selecione Copiar link.
4. Cole o link no Bloco de Notas ou em um aplicativo semelhante. O link é semelhante ao seguinte 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 o segmento da URL que está entre chat/ e o próximo /. O segmento geralmente é precedido por 19:. Este é o chatId. No exemplo anterior, o chatId é 19:12ab3c4d-a123-12a3-a123-123ab12c12de_12a3bcd4-1234-1234-123a-1b2345c678d9@unq.gbl.spaces.
6. Adicione a chatId ao link profundo. Por exemplo: https://teams.microsoft.com/l/chat/19:12ab3c4d-a123-12a3-a123-123ab12c12de_12a3bcd4-1234-1234-123a-1b2345c678d9@unq.gbl.spaces/conversations.

Para obter mais informações, consulte Link profundo para o chat do Teams.

Reuniões de Teams

Usando o conhecimento de reuniões do Teams, você pode definir o escopo do seu agente para responder a perguntas sobre reuniões, incluindo reuniões individuais ou séries de reuniões. Por exemplo, seu agente pode responder a perguntas como "Recapitular reuniões de ontem e listar itens de ação" ou "O que foi dito sobre o Projeto X em minhas reuniões?". Opcionalmente, você pode definir o escopo dessa fonte de conhecimento para até cinco reuniões específicas. Essa fonte de conhecimento fornece ao agente acesso aos metadados da reunião (assunto, organizador, participantes e título), conteúdo de transcrição e chats de reunião.

Adicionar fonte de conhecimento de reuniões

Se você estiver usando o Agent Builder para criar seu agente, na guia Configurar , na seção Conhecimento , selecione a barra de pesquisa e escolha Meus chats e reuniões do Teams. A capacidade de escopo para Reuniões estará disponível em breve no Agent Builder.

Se você estiver usando o Agents Toolkit e o Visual Studio Code para criar seu agente, para habilitar o conhecimento de reuniões, adicione o valor à propriedade capabilities no arquivo de manifesto Meetings do agente, conforme mostrado no exemplo a seguir. Se você quiser definir o escopo do agente para reuniões específicas, adicione o UID da reunião à items_by_id propriedade. Para obter instruções sobre como localizar a ID de uma reunião, consulte Obter a ID de uma reunião.

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

Conteúdo relacionado

• Visão geral dos agentes declarativos
• Referência do manifesto do agente declarativo
• Adicionar o recurso de interpretador de código ao seu agente
• Adicione o recurso de geração de imagens ao seu agente