Adicionar fontes de conhecimento ao seu agente declarativo

Dica

Recomendado: Comece com o Work IQ Dev Tools para cenários de agente declarativo e plug-in pro-código suportados. Consulte o guia de início rápido do WIQD. As instruções baseadas em toolkits permanecem disponíveis para projetos e fluxos de trabalho existentes que o exigem. Verifique o suporte à capacidade e à experiência de destino antes de escolher uma ferramenta: o WIQD não tem como alvo agentes de mecanismo personalizados.

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

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

Esta tabela descreve os caminhos de configuração do Agent Builder e do Toolkit, não a cobertura do recurso WIQD. Para a rota pró-código recomendada, confirme a configuração suportada na documentação do WIQD.

Capacidades ou origens de conhecimento Construtor de Agentes Kit de Ferramentas de Agentes É necessária licença ou utilização com tráfego limitado?
Interpretador de código ✅ ✅ Não
Gerador de imagem ✅ ✅ Não
Conectores do Copilot ✅ ✅ Sim
SharePoint ✅ ✅ Sim
OneDrive ✅ ✅ Sim
Conteúdo de ficheiro incorporado ✅ ❌ Sim
Pesquisa na Web ✅ ✅ Não
Pesquisa na Web com âmbito ✅ ✅ Não
Dataverse ✅ ✅* Sim
Email ✅ ✅* Sim (apenas licença)
Pessoas ✅ ✅ Sim (apenas licença)
Páginas do OneNote ✅ ❌ Não
Mensagens do Teams ✅ ✅* Sim (apenas licença)
Reuniões do Teams ✅ ✅ Sim (apenas licença)

* Opção para delimitar o conhecimento está disponível.

Conectores do Copilot

Microsoft 365 Copilot conectores permitem que você adicione dados organizacionais ao seu agente como informações de base. Utilize os conectores do Copilot para ingerir os seus dados de linha de negócio para o Microsoft Graph, para que o Copilot possa raciocinar sobre os seus dados como informações de base em respostas aos pedidos dos utilizadores. Para obter mais informações, consulte Visão geral de conectores Microsoft 365 Copilot.

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

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

SharePoint e OneDrive

Quando configura o seu agente para utilizar os conteúdos do SharePoint e do OneDrive como conhecimento, o Copilot procura ficheiros, pastas ou sites do SharePoint e do OneDrive a que um utilizador tem acesso para obter informações de base.

Para obter informações sobre como adicionar conhecimento do SharePoint e OneDrive ao manifesto do agente no Agents Toolkit, consulte OneDrive e objeto do SharePoint.

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

Observação

As origens de conhecimento do SharePoint e OneDrive exigem que o utilizador com sessão iniciada tenha uma licença de Microsoft 365 Copilot ativa. Se o utilizador não tiver uma licença, os pedidos falham com a mensagem Lamentamos, mas não consegui responder.

As contas de inquilino das Experiências Digitais do Cliente (CDX) sem uma licença do Copilot podem publicar agentes, mas não podem executar a recuperação baseada no SharePoint. Utilize a Licença de Programador Microsoft 365 Copilot para testar cenários em ambientes que não sejam de produção.

A pesquisa na Web permite que os agentes utilizem o índice de pesquisa no Bing para responder aos pedidos dos utilizadores. Se você habilitar a pesquisa na Web em seu agente, seu agente poderá retornar quaisquer dados da Web em suas respostas. Também pode abranger até quatro sites públicos ao âmbito da pesquisa na Web.

Importante

Os administradores da organização podem desativar a pesquisa na Web do Copilot e de todos os agentes dentro da sua organização. Se os administradores desativarem a pesquisa na Web, os agentes com a pesquisa na Web ativada não comunicarão um erro e não incluirão pesquisas na Web com o seu conhecimento. Os cartões de depuração do modo de programador indicam que a pesquisa na Web é ativada se o agente a tiver ativado, mesmo que os administradores a tenham desativado. Para obter mais informações, consulte Gerenciar cenários de Microsoft 365 Copilot no Centro de administração do Microsoft 365.

Se você estiver usando o Agents Toolkit e 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 abranger sites específicos, adicione a propriedade sites e especifique até quatro URLs, conforme apresentado no exemplo seguinte.

Observação

Para adicionar a pesquisa na Web com escopo ao seu agente, use a versão 1.3 ou posterior do esquema de manifesto do agente declarativo.

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

Se você estiver usando o Agent Builder para criar seu agente, na guia Configurar , em Conhecimento, liste as URLs de sites que deseja referenciar.

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

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

A pesquisa na Web do âmbito baseia-se no conteúdo que o Bing indexa para os sites configurados. Como resultado, o conteúdo que depende da renderização do lado do cliente ou dos 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 ao vivo.

Esse comportamento pode produzir resultados inconsistentes. O conteúdo apresentado num site pode ser diferente do conteúdo disponível para o agente e este pode não devolver de forma fiável os itens mais recentes de listas geradas dinamicamente ou atualizadas com frequência.

Esse comportamento é esperado com a arquitetura atual do agente declarativo. 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 que muda frequentemente 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 resultados, 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 suportada. Para obter orientações sobre estas abordagens, consulte:

Conteúdo de ficheiro incorporado

Se você estiver usando o Agent Builder para criar seu agente, poderá carregar arquivos diretamente do seu dispositivo ou da nuvem para incorporar o conteúdo para seu agente usar como conhecimento. O conteúdo do ficheiro incorporado é armazenado no SharePoint Embedded. Estes ficheiros são contabilizados em relação à capacidade do OneDrive e do SharePoint no seu inquilino.

Observação

  • A funcionalidade de carregamento de ficheiros está disponível para utilizadores com a faturação de utilização ativada ou com uma licença Microsoft 365 Copilot.
  • Os conteúdos de ficheiros incorporados não são suportados em ambientes de Nuvem da Comunidade Governamental do Microsoft 365 (GCC).

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

Importante

As Barreiras de Informação (IB) do Microsoft Purview não são suportadas em ficheiros incorporados. Qualquer usuário que possa acessar o agente pode ver respostas fundamentadas no conteúdo do arquivo incorporado.

Dataverse

O conhecimento do Dataverse permite que os agentes respondam em linguagem natural às consultas dos usuários sobre seus dados do 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ê usar o Agent Builder para criar seu agente, selecione Dynamics 365 e PowerApps na guia Configurar na seção Conhecimento. Selecione + para localizar a aplicação que pretende incluir e selecione a aplicação ou deixe-a como está para pesquisar em todas as aplicações. Você pode acessar o conhecimento do Dataverse no Agent Builder por meio de Aplicativos de Negócios no Work IQ, que um administrador deve habilitar primeiro.

Se estiver a utilizar o Agents Toolkit e o Visual Studio Code para criar o seu agente, adicione o valor à propriedade no seu ficheiro de manifesto do agente para ativar o Dataversecapabilities conhecimento do Dataverse, conforme mostrado no exemplo seguinte.

Observação

Para adicionar Dataverse conhecimentos, use a versão 1.3 ou posterior do esquema de manifesto do agente declarativo.

{
  "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 em sua matriz de recursos existe em seu ambiente Dataverse. Além disso, certifique-se de que o valor corresponde ao ID da host_name sua organização.

Obter um valor de competência preexistente ou criar um novo

Para obter ou criar um valor Dataverse skill :

  1. Obtenha o ID da sua organização a partir dasDefinições> do Portal do Programador do Power> AppsRecursos para programadores.

  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 contém uma lista de habilidades existentes DVTableSearch em seu ambiente 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"
    

    Resposta

    {
     "@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, utilize-o no ficheiro de manifesto do agente. Se o skill valor não existir, a resposta conterá uma matriz vazia.

    Resposta

    {
      "@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 competência e utilize o nome que lhe atribuir.

    Solicitar

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

    Resposta

    A solicitação retorna 204 Sem Conteúdo para indicar que a DVTableSearch habilidade foi criada com êxito.

    HTTP/1.1 204 No Content
    
  5. Execute novamente o pedido de curvatura no Passo 3 para marcar uma competência existenteDVTableSearch. A resposta contém o dvtablesearchid do recém-criado skill. Você pode usar esse valor ou o name valor na propriedade do arquivo de manifesto skill do agente.

Email

Email conhecimento permite-lhe definir o âmbito do seu agente para uma caixa de correio pessoal ou partilhada e, opcionalmente, para uma pasta de caixa de correio específica.

Adicionar fontes de conhecimento de e-mail

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

Observação

Atualmente, não é possível definir o âmbito dos seus e-mails para uma pasta específica ou caixa de correio partilhada quando utiliza o Construtor de Agentes.

Se você estiver usando o Agents Toolkit e Visual Studio Code para criar seu agente, para adicionar conhecimento de email, adicione o valor à propriedade capabilities em seu arquivo de manifesto Email do agente, conforme mostrado no exemplo a seguir. Pode referenciar múltiplas pastas de caixa de correio e apenas uma pasta partilhada.

Observação

Você deve estar usando a versão 1.3 ou posterior do esquema de manifesto do agente declarativo para adicionar Email conhecimento.

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

No campo folder_id , pode fazer referência a nomes de pastas 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, utilize a seguinte consulta no Graph Explorer:

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

No campo shared_mailbox , utilize o endereço SMTP da caixa de correio partilhada.

No campo group_mailboxes , especifique uma array das cadeias de carateres (até 25) que contêm os endereços SMTP das caixas de correio partilhadas ou grupos do Microsoft 365 para os quais pretende que o seu agente tenha o âmbito.

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

Se não fizer referência a uma caixa de correio ou pasta partilhada, a pesquisa do agente não tem o âmbito de nenhuma pasta ou caixa de correio e devolve resultados de todo o conteúdo do e-mail com base na consulta do utilizador.

Pessoas

Fundamente o seu agente em People dados para fornecer respostas mais personalizadas e sensíveis ao contexto. People dados combinam informações públicas sobre indivíduos, como nome, cargo, habilidades e relacionamentos organizacionais, com uma visão pessoal das conexões, colaboradores e percepções relevantes do usuário. Essa fonte de conhecimento permite que os agentes:

  • Procure perfis de utilizador e de colega, incluindo a estrutura hierárquica e os detalhes de contacto.
  • Identificar especialistas em domínios e colaboradores-chave dentro da organização.
  • Personalize as respostas com base nas relações do utilizador, interações anteriores e preferências.
  • Forneça recomendações e sugestões de comunicação adaptadas a equipas ou indivíduos específicos.

Adicionar a origem de conhecimento de pessoas

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

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

Observação

Para adicionar a People fonte de conhecimento (sem conteúdo relacionado), use a versão 1.3 ou posterior do esquema de manifesto do agente declarativo. Para utilizar a propriedade, utilize a include_related_contentversão 1.6 ou posterior.

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

Se o agente precisar raciocinar sobre o conteúdo relacionado (entre o usuário do agente e as pessoas referenciadas), como mensagens, e-mails e arquivos relacionados da equipe, aproveite a include_related_content propriedade. O valor padrão é false.

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

Páginas do OneNote

Quando utiliza o Microsoft 365 Copilot para criar o seu agente, pode escolher páginas específicas do OneNote a partir do seletor de ficheiros para carregar como conhecimento. Apenas pode selecionar páginas individuais do OneNote. A opção para selecionar um bloco de notas inteiro do OneNote não está disponível.

Utilize o seletor de ficheiros para adicionar páginas do OneNote. O Agent Builder não suporta a introdução de URLs de páginas do OneNote.

Mensagens do Teams

Pode configurar os agentes para utilizarem os canais do Teams, conversas de reunião, conversas de grupo e conversas individuais como fontes de conhecimento. Pode optar por especificar até cinco ligações para canais, conversas de grupo, individuais ou de reuniões para definir o âmbito da pesquisa do Copilot ou pode permitir que o seu agente utilize o conteúdo do Teams do utilizador, incluindo canais, reuniões e conversas individuais e de grupo, como fontes de conhecimento.

Os agentes podem devolver ligações para ficheiros partilhados em mensagens do Teams, mas não podem devolver ligações para ficheiros armazenados num canal do Teams, a menos que o agente também tenha OneDriveAndSharePoint ativado. Para obter informações sobre como otimizar o conteúdo do SharePoint para o Copilot, consulte Otimizar a obtenção de conteúdo.

Adicionar mensagens do Teams, fontes de conhecimento

Se estiver a utilizar o Agent Builder para criar o seu agente, no separador Configurar , na secção Conhecimento , selecione a barra de pesquisa e escolha As minhas conversas e reuniões do Teams. Para direcionar o seu agente para conversas de canal, reunião ou grupo específicas, no separador Conversas , selecione as conversas que pretende adicionar como conhecimento.

Se estiver a utilizar o Agents Toolkit e o Visual Studio Code para criar o seu agente, para permitir o conhecimento das mensagens do Teams, adicione o valor à propriedade de capacidades na sua referência de manifestoTeamsMessage. Se pretender alargar o âmbito de conhecimento do Teams a até cinco recursos do Teams, adicione as ligações à propriedade urls , conforme apresentado no exemplo seguinte.

Observação

Tem de utilizar a versão 1.3 ou posterior do esquema de manifesto do agente declarativo para adicionar a TeamsMessage origem de conhecimento.

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

Obter o URL de um canal ou reunião

Para obter o URL de um canal do Teams, selecione os três pontos (...) junto ao nome do canal e selecione Obter ligação para o canal.

Para obter o URL para uma reunião do Teams, abra a reunião, selecione a seta junto a Participar e selecione a ligação Copiar participação.

Obter o URL de um grupo ou chat com outra pessoa

Para obter o URL de um grupo ou chat com outra pessoa, necessita de uma ligação direta que inclua o chatId. O deep link tem o seguinte formato: https://teams.microsoft.com/l/chat/<chatId>/conversations. O valor chatId é diferente para cada chat.

Para obter o valor chatId de um grupo ou chat individual:

  1. No Microsoft Teams, aceda a qualquer mensagem na conversa.
  2. Paire o cursor sobre a mensagem e selecione os três pontos (...).
  3. Selecione Copiar ligação.
  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 do 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.

Observação

A referência a uma série de reuniões é limitada às últimas quatro instâncias da série.

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.

Observação

Você deve estar usando a versão 1.6 ou posterior do esquema de manifesto do agente declarativo para adicionar a Meetings fonte de conhecimento.

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