Adicionar origens de conhecimento ao agente declarativo

Pode melhorar a experiência de utilizador do seu agente declarativo ao adicionar capacidades como interpretador de código , gerador de imagens e origens de conhecimento para melhorar e personalizar os conhecimentos do agente. O objeto de capacidades na referência de manifesto e na secção Conhecimento no Microsoft 365 Copilot fornecer várias opções para desbloquear funcionalidades para os seus utilizadores. Este artigo descreve as origens de conhecimento que pode adicionar aos seus agentes.

A tabela seguinte lista as capacidades e origens de conhecimento que pode configurar ao utilizar Microsoft 365 Copilot ou o Toolkit de Agentes do Microsoft 365 e indica se os utilizadores precisam de uma licença Microsoft 365 Copilot ou uma utilização limitada para aceder a agentes com essa capacidade ou origem de conhecimento.

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

Conectores do Copilot

Microsoft 365 Copilot conectores permitem-lhe adicionar dados organizacionais ao agente como informações de base. Pode utilizar conectores Copilot para ingerir os seus dados de linha de negócio no Microsoft Graph e o Copilot pode considerar os seus dados como informações de base em respostas a pedidos do utilizador. Para saber mais, confira a Visão geral dos conectores do Microsoft 365 Copilot.

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

Para obter informações sobre como adicionar conectores Copilot ao agente no Microsoft 365 Copilot, consulte Conectores copilot.

SharePoint e OneDrive

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

Para obter informações sobre como adicionar conhecimentos do OneDrive e do SharePoint ao seu manifesto de agente no Toolkit de Agentes, consulte OneDrive e objeto do SharePoint.

Para obter informações sobre como adicionar conhecimentos do SharePoint ao seu agente no Microsoft 365 Copilot, consulte Adicionar origens de conhecimento.

Pesquisa na Web e no âmbito

A pesquisa na Web permite que os agentes utilizem o índice de pesquisa no Bing para responder a pedidos do utilizador. Se ativar a pesquisa na Web no seu agente, pode fazer com que o agente devolva quaisquer dados Web nas respetivas respostas. Também pode definir o âmbito da pesquisa na Web para até quatro sites públicos.

Adicionar pesquisa na Web e no âmbito

Se estiver a utilizar o Toolkit de Agentes e Visual Studio Code para criar o agente, para ativar a pesquisa na Web, adicione o WebSearch valor à propriedade capabilities no seu ficheiro de manifesto. Se quiser definir o âmbito da pesquisa na Web para sites específicos, adicione a propriedade sites e especifique até quatro URLs, conforme mostrado no exemplo seguinte.

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

Se estiver a utilizar Microsoft 365 Copilot para criar o agente, no separador Configurar, em Conhecimento, liste os URLs do site que pretende referenciar.

Conteúdo do ficheiro incorporado

Se estiver a utilizar Microsoft 365 Copilot para criar o agente, pode carregar ficheiros diretamente a partir do seu dispositivo ou da cloud para incorporar os conteúdos que o seu agente deve utilizar como conhecimento. O conteúdo do ficheiro incorporado é armazenado no SharePoint Embedded. Estes ficheiros contam para a capacidade do OneDrive e do SharePoint no seu inquilino.

Para obter mais informações sobre ficheiros incorporados, veja Conteúdo de ficheiro incorporado.

Dataverse

O conhecimento dataverse permite que os agentes respondam em linguagem natural a consultas dos utilizadores sobre os respetivos dados crm ou dados de tabelas no Microsoft Dataverse. Pode adicionar uma instância do Dataverse como uma origem de conhecimento e adicionar sinónimos e um glossário para ajudar o sistema a interpretar melhor os dados personalizados nas suas tabelas. Para obter mais informações, veja Adicionar uma origem de conhecimento Dataverse.

Adicionar conhecimentos do Dataverse

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

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

Email

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

Adicionar origens de conhecimento de e-mail

Se estiver a utilizar Microsoft 365 Copilot para criar o agente, no separador Configurar na secção Conhecimento, selecione Os meus e-mails.

Se estiver a utilizar o Toolkit de Agentes e Visual Studio Code para criar o seu agente, para adicionar conhecimentos de e-mail, adicione o Email valor à propriedade capabilities no ficheiro de manifesto do agente, conforme mostrado no exemplo seguinte. Pode referenciar múltiplas pastas de caixa de correio e apenas uma pasta partilhada.

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

No campo folder_id , pode referenciar nomes de pastas ou IDs de pasta bem conhecidos. Para obter uma lista de nomes de pastas conhecidos, consulte mailFolder resource type (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 , pode especificar uma array das cadeias (até 25) que contêm os endereços SMTP das caixas de correio partilhadas ou dos grupos do Microsoft 365 para os quais pretende que o seu agente esteja no âmbito.

Se referenciar uma caixa de correio partilhada e uma pasta, o agente aprovisiona as respostas à pasta na caixa de correio partilhada. Se referenciar apenas uma pasta, o agente aprovisiona as respostas aos conteúdos da pasta na caixa de correio pessoal.

Se não referenciar uma caixa de correio partilhada ou uma pasta, a pesquisa do agente não está confinada a nenhuma pasta ou caixa de correio e devolve os resultados de todos os conteúdos de e-mail, com base na consulta do utilizador.

Pessoas

Pode colocar o seu agente no Pessoas dados para fornecer respostas mais personalizadas e com deteção de contexto. Pessoas dados combinam informações públicas sobre indivíduos (como nome, posição, competências e relações organizacionais) com uma visão pessoal das ligações, colaboradores e informações relevantes do utilizador. Esta origem de conhecimento permite que os agentes:

• Procure perfis de utilizadores e colegas, incluindo a estrutura de relatórios e os detalhes de contacto.
• Identifique especialistas de domínio e colaboradores-chave na organização.
• Personalize as respostas com base nas relações do utilizador, nas interações passadas e nas preferências.
• Forneça recomendações e sugestões de comunicação adaptadas a equipas ou indivíduos específicos.

Adicionar uma origem de conhecimento de pessoas

Se estiver a utilizar Copilot Studio para criar o seu agente, a origem de conhecimento Pessoas está ativada por predefinição para utilizadores com uma licença de Microsoft 365 Copilot.

Se estiver a utilizar o Toolkit de Agentes e Visual Studio Code para criar o seu agente, para ativar o conhecimento das pessoas, adicione o People valor à propriedade capabilities no ficheiro de manifesto do agente, conforme mostrado no exemplo seguinte. Declarar apenas a capacidade base People permitirá ao agente raciocinar apenas os dados básicos da organização, como os disponíveis no perfil card. Se quiser incluir conteúdos como mensagens de equipas relacionadas, e-mails e ficheiros entre o utilizador do agente e as pessoas referenciadas na organização, consulte a versão 1.6 para utilizar a include_related_content propriedade.

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

Caso necessite que o seu agente deva raciocinar sobre os conteúdos relacionados (entre o utilizador do agente e as pessoas referenciadas), como mensagens de equipas relacionadas, e-mails e ficheiros, pode tirar partido do include_related_content. O valor padrão é false.

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

Mensagens do Teams

Pode configurar agentes para utilizar canais do Teams, conversas de reunião, conversas de grupo e conversas 1:1 como origens de conhecimento. Pode optar por especificar até cinco ligações para canais, grupos, 1:1 ou conversas de reunião para definir o âmbito da pesquisa copilot ou pode permitir que o seu agente utilize os conteúdos 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 conteúdos do SharePoint para Copilot, veja Otimizar a obtenção de conteúdos do SharePoint.

Adicionar origens de conhecimento de mensagens do Teams

Se estiver a utilizar Microsoft 365 Copilot para criar o seu agente, no separador Configurar, na secção Conhecimento, selecione a barra de pesquisa e selecione As minhas conversas e reuniões do Teams. Para definir o âmbito do seu agente para conversas de canal, reunião ou grupo específicas, no separador Chats, selecione as conversas que pretende adicionar como conhecimento.

Se estiver a utilizar o Toolkit de Agentes e Visual Studio Code para criar o seu agente, para ativar o conhecimento das mensagens do Teams, adicione o TeamsMessage valor à propriedade capabilities na sua referência de manifesto. Se quiser definir o âmbito do conhecimento do Teams para até cinco recursos do Teams, adicione as ligações à propriedade URLs , conforme mostrado no exemplo seguinte.

{
  "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 de uma reunião do Teams, abra a reunião, selecione a seta junto a Participar e selecione Copiar ligação para participar.

Obter o URL de um grupo ou chat 1:1

Para obter o URL de um grupo ou chat 1:1, precisa de uma ligação avançada que inclua o chatId. A ligação avançada tem o seguinte formato: https://teams.microsoft.com/l/chat/<chatId>/conversations. O valor de chatId é diferente para cada conversa.

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

1. No Microsoft Teams, aceda a qualquer mensagem no chat.
2. Paire o cursor sobre a mensagem e selecione os três pontos (...).
3. Selecione Copiar link.
4. Cole a ligação no Bloco de Notas ou numa aplicação semelhante. A ligação tem um aspeto 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 do URL que se insere entre chat/ e o seguinte /. Normalmente, o segmento é 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 o chatId à ligação avançada. 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 Ligação avançada ao chat do Teams.

Reuniões de Teams

O conhecimento das reuniões do Teams permite-lhe definir o âmbito do seu agente para responder a perguntas sobre reuniões, incluindo reuniões individuais ou séries de reuniões. Por exemplo, o seu agente pode responder a consultas como "Recapitular as reuniões de ontem e listar itens de ação" ou "O que foi dito sobre o Project X nas minhas reuniões?". Opcionalmente, esta origem de conhecimento pode ser confinada a até cinco reuniões específicas. Esta origem de conhecimento dá ao agente acesso aos metadados da reunião (assunto, organizador, participantes e título), conteúdo de transcrição e conversas de reunião.

Adicionar origem de conhecimento de reuniões

Se estiver a utilizar Microsoft 365 Copilot para criar o seu agente, no separador Configurar, na secção Conhecimento, selecione a barra de pesquisa e selecione As minhas conversas e reuniões do Teams. A capacidade de definir o âmbito das Reuniões estará disponível em breve no Microsoft 365 Copilot.

Se estiver a utilizar o Toolkit de Agentes e Visual Studio Code para criar o agente, para ativar o conhecimento das reuniões, adicione o Meetings valor à propriedade capabilities no ficheiro de manifesto do agente, conforme mostrado no exemplo seguinte. Se quiser definir o âmbito do agente para reuniões específicas, adicione o UID da reunião à items_by_id propriedade . Para obter instruções sobre como encontrar o ID de uma reunião, consulte Obter o ID de uma reunião.

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

Conteúdo relacionado

• Descrição geral dos agentes declarativos
• Referência do manifesto do agente declarativo
• Adicionar a capacidade de intérprete de código ao agente
• Adicionar a capacidade do gerador de imagens ao agente