Добавление источников знаний в декларативный агент

Вы можете улучшить пользовательский интерфейс декларативного агента, добавив такие возможности, как интерпретатор кода и генератор изображений , а также источники знаний для расширения и настройки знаний агента. Объект capabilities в справочнике по манифесту и в разделе "Знания" в Microsoft 365 Copilot предоставляет несколько вариантов разблокировки функций для пользователей. В этой статье описаны источники знаний, которые можно добавить в агенты.

В следующей таблице перечислены возможности и источники знаний, которые можно настроить с помощью Microsoft 365 Copilot или Microsoft 365 Agents Toolkit, а также указано, требуется ли пользователям лицензия на Microsoft 365 Copilot или лимитное использование для доступа к агентам с этой возможностью или источником знаний.

* Возможность область доступны знания.

Соединители Copilot

соединители Microsoft 365 Copilot позволяют добавлять данные организации в агент в качестве сведений о заземления. Используйте соединители Copilot для приема бизнес-данных в Microsoft Graph, чтобы Copilot могла обосновать ваши данные как заземляющую информацию в ответ на запросы пользователей. Дополнительные сведения см. в статье Общие сведения о соединителях Microsoft 365 Copilot.

Сведения о том, как добавить соединители Copilot в качестве знаний в манифест агента в наборе средств агентов, см. в разделе Объект соединителей Copilot.

Сведения о добавлении соединителей Copilot в агент в Microsoft 365 Copilot см. в разделе Соединители Copilot.

SharePoint и OneDrive

При настройке агента для использования oneDrive и содержимого SharePoint в качестве знаний Copilot выполняет поиск в sharePoint и OneDrive файлов, папок или сайтов, к которым у пользователя есть доступ, для получения сведений об основах.

Сведения о том, как добавить знания OneDrive и SharePoint в манифест агента в наборе средств агентов, см. в статье OneDrive и объект SharePoint.

Сведения о добавлении знаний SharePoint в агент в Microsoft 365 Copilot см. в разделе Добавление источников знаний.

Поиск в Интернете и в интернете с заданной областью

Поиск в Интернете позволяет агентам использовать индекс поиска в Bing для реагирования на запросы пользователей. Если вы включите поиск в интернете в агенте, агент может вернуть любые веб-данные в своих ответах. Вы также можете область поиск в Интернете до четырех общедоступных веб-сайтов.

Добавление веб-поиска и поиска в интернете

Если вы используете набор средств агентов и Visual Studio Code для создания агента, добавьте WebSearch значение в свойство capabilities в файле манифеста, чтобы включить поиск в Интернете. Чтобы область веб-поиск на определенных сайтах, добавьте свойство sites и укажите до четырех URL-адресов, как показано в следующем примере.

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

Если вы используете Microsoft 365 Copilot для создания агента, на вкладке Настройка в разделе Знания укажите URL-адреса веб-сайта, на которые вы хотите ссылаться.

Внедренное содержимое файла

Если вы используете Microsoft 365 Copilot для создания агента, вы можете отправлять файлы непосредственно с устройства или облака, чтобы внедрить содержимое, которое агент будет использовать в качестве знаний. Содержимое внедренного файла хранится в SharePoint Embedded. Эти файлы учитываются в емкости OneDrive и SharePoint в клиенте.

Дополнительные сведения о внедренных файлах см. в разделе Внедренное содержимое файлов.

Dataverse

Знание Dataverse позволяет агентам отвечать на естественном языке на запросы пользователей о данных CRM или данные из таблиц в Microsoft Dataverse. Вы можете добавить экземпляр Dataverse в качестве источника знаний, а также синонимы и глоссария, чтобы помочь системе лучше интерпретировать настраиваемые данные в таблицах. Дополнительные сведения см. в статье Добавление источника знаний Dataverse.

Добавление знаний Dataverse

Если вы используете Набор средств агентов и Visual Studio Code для создания агента, добавьте Dataverse значение capabilities в свойство в файле манифеста агента, чтобы включить знания Dataverse, как показано в следующем примере.

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

Перед добавлением этого навыка убедитесь, что значение в массиве skill возможностей существует в среде Dataverse. Кроме того, убедитесь, что host_name значение соответствует идентификатору организации.

Получение уже существовающего значения навыка или создание нового

Чтобы получить или создать значение Dataverse skill , выполните приведенные далее действия.

1. Получитеидентификатор организации из портала >Разработчика Power AppsПараметры >ресурсов разработчика.

2. Получите маркер носителя для проверки подлинности и создания ресурсов Dataverse. Чтобы получить маркер носителя, создайте новую регистрацию приложения в портал Azure, а затем выполните следующий запрос 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. Определите, skill существует ли значение, с помощью следующего запроса curl. skill Если значение уже существует, ответ содержит список существующих DVTableSearch навыков в среде 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"
   

   Отклик

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

   skill Если значение уже существует, используйте его в файле манифеста агента. skill Если значение не существует, ответ содержит пустой массив.

   Отклик

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

4. Если этот навык не skill существует, создайте DVTableSearch навык и используйте имя, присвоенное ему.

   Запрос

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

   Отклик

   Запрос возвращает значение 204 No Content , чтобы указать, что DVTableSearch навык был успешно создан.

   HTTP/1.1 204 No Content
   

5. Запустите запрос curl на шаге 3 еще раз, чтобы проверка для существующего DVTableSearch навыка. Ответ содержит dvtablesearchid объект только что созданного skillобъекта . Это значение или name значение можно использовать в свойстве skill файла манифеста агента.

Электронная почта

Email знания позволяют область агента в личный или общий почтовый ящик, а также, при необходимости, в определенную папку почтового ящика.

Добавление источников знаний по электронной почте

Если вы используете Microsoft 365 Copilot для создания агента, на вкладке Настройка в разделе Знания выберите Мои сообщения электронной почты.

Если вы используете набор средств агентов и Visual Studio Code для создания агента, чтобы добавить знания по электронной почте, добавьте Email значение в свойство capabilities в файле манифеста агента, как показано в следующем примере. Можно ссылаться на несколько папок почтовых ящиков и только одну общую папку.

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

В поле folder_id можно ссылаться на известные имена папок или идентификаторы папок. Список известных имен папок см. в разделе Тип ресурса mailFolder. Чтобы получить список идентификаторов папок, используйте следующий запрос в Graph Обозреватель:

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

В поле shared_mailbox используйте SMTP-адрес общего почтового ящика.

В поле group_mailboxes укажите array из строк (до 25), содержащих SMTP-адреса общих почтовых ящиков или групп Microsoft 365, для области действия агента.

Если вы ссылаетесь как на общий почтовый ящик, так и на папку, агент будет отвечать на эту папку в общем почтовом ящике. Если вы ссылаетесь только на папку, агент будет отвечать на содержимое папки в личном почтовом ящике.

Если вы не ссылаетесь на общий почтовый ящик или папку, поиск агента не ограничивается ни одной папкой или почтовым ящиком и возвращает результаты из всего содержимого электронной почты на основе запроса пользователя.

Люди

Заземляйте агент в Люди данных, чтобы предоставлять более персонализированные и контекстно-персонализированные ответы. Люди данные объединяют общедоступную информацию о людях, такую как имя, должность, навыки и организационные отношения, с личным представлением о связях пользователей, участниках совместной работы и соответствующей аналитике. Этот источник знаний позволяет агентам:

• Поиск профилей пользователей и коллег, включая структуру отчетов и контактные данные.
• Определите экспертов по предметной области и ключевых участников совместной работы в организации.
• Персонализируйте ответы на основе отношений пользователя, предыдущих взаимодействий и предпочтений.
• Предоставляйте рекомендации и советы по коммуникации, предназначенные для конкретных команд или отдельных пользователей.

Добавление источника знаний о людях

Если для создания агента используется Copilot Studio, Люди источник знаний по умолчанию включен для пользователей с лицензией Microsoft 365 Copilot.

Если вы используете набор средств агентов и Visual Studio Code для создания агента, добавьте People значение в свойство capabilities в файле манифеста агента, чтобы предоставить людям знания, как показано в следующем примере. Объявление только базовой People возможности позволяет агенту рассуждать только на базовых данных организации, таких как доступные в профиле карта. Сведения о том, как включить такое содержимое, как связанные сообщения команд, сообщения электронной почты и файлы между пользователем агента и пользователями, на которые ссылается организация, см . в версии 1.6 для использования include_related_content свойства .

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

Если агенту нужно обясказать связанное содержимое (между пользователем агента и пользователями, на которые ссылается ссылка), например сообщения связанных команд, сообщения электронной почты и файлы, используйте include_related_content свойство . Значение по умолчанию — false.

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

Сообщения Teams

Агенты могут использовать каналы Teams, чаты собраний, групповые чаты и чаты 1:1 в качестве источников знаний. Вы можете указать до пяти ссылок на каналы, группы, 1:1 или чаты собраний для область поиска Copilot, или вы можете разрешить агенту использовать содержимое Teams пользователя, включая каналы, собрания, индивидуальные и групповые чаты, в качестве источников знаний.

Агенты могут возвращать ссылки на файлы, к которым предоставлен доступ в сообщениях Teams, но они не могут возвращать ссылки на файлы, хранящиеся в канале Teams, если агент также не включил OneDriveAndSharePoint . Сведения об оптимизации содержимого SharePoint для Copilot см. в статье Оптимизация извлечения содержимого SharePoint.

Добавление источников знаний сообщений Teams

Если вы используете Microsoft 365 Copilot для создания агента, на вкладке Настройка в разделе "Знания" выберите панель поиска и выберите Чаты и собрания Мои Teams. Чтобы область агента к определенному каналу, собранию или групповым чатам, на вкладке Чаты выберите чаты, которые нужно добавить в качестве знаний.

Если вы используете набор средств агентов и Visual Studio Code для создания агента, чтобы включить знания о сообщениях Teams, добавьте TeamsMessage значение в свойство capabilities в справочнике по манифесту. Если вы хотите область знания Teams до пяти ресурсов Teams, добавьте ссылки в свойство urls, как показано в следующем примере.

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

Получение URL-адреса канала или собрания

Чтобы получить URL-адрес для канала Teams, щелкните три точки (...) рядом с именем канала и выберите Получить ссылку на канал.

Чтобы получить URL-адрес для собрания Teams, откройте собрание, щелкните стрелку рядом с элементом Присоединиться и выберите Копировать ссылку присоединения.

Получение URL-адреса для группы или чата 1:1

Чтобы получить URL-адрес для группы или чата 1:1, необходима прямая ссылка, содержащая chatId. Прямая ссылка имеет следующий формат: https://teams.microsoft.com/l/chat/<chatId>/conversations. Значение chatId отличается для каждого чата.

Чтобы получить значение chatId для группы или чата 1:1, выполните следующие действия:

1. В Microsoft Teams перейдите к любому сообщению в чате.
2. Наведите указатель мыши на сообщение и выберите три точки (...).
3. Выберите Копировать ссылку.
4. Вставьте ссылку в Блокнот или аналогичное приложение. Ссылка выглядит примерно так: 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. Скопируйте сегмент URL-адреса, который находится между chat/ и следующим /. Сегмент обычно предваряется 19:. Это chatId. В предыдущем примере значением chatId является 19:12ab3c4d-a123-12a3-a123-123ab12c12de_12a3bcd4-1234-1234-123a-1b2345c678d9@unq.gbl.spaces.
6. Добавьте chatId в прямую ссылку. Пример: https://teams.microsoft.com/l/chat/19:12ab3c4d-a123-12a3-a123-123ab12c12de_12a3bcd4-1234-1234-123a-1b2345c678d9@unq.gbl.spaces/conversations.

Дополнительные сведения см. в разделе Прямая ссылка на чат Teams.

Собрания Teams

Используя знания о собраниях Teams, вы можете область своего агента, чтобы ответить на вопросы о собраниях, включая отдельные собрания или серии собраний. Например, ваш агент может отвечать на такие запросы, как "Возврат вчерашних собраний и элементов действий списка" или "Что было сказано о Project X в моих собраниях?". При необходимости можно область этот источник знаний до пяти определенных собраний. Этот источник знаний предоставляет агенту доступ к метаданным собрания (тема, организатор, участники и название), содержимому расшифровки и чатам собрания.

Добавление источника знаний о собраниях

Если вы используете Microsoft 365 Copilot для создания агента, на вкладке Настройка в разделе "Знания" выберите панель поиска и выберите Чаты и собрания Мои Teams. Возможность область на собрания скоро появится в Microsoft 365 Copilot.

Если вы используете набор средств агентов и Visual Studio Code для создания агента, чтобы включить знания о собраниях, добавьте Meetings значение в свойство capabilities в файле манифеста агента, как показано в следующем примере. Если вы хотите область агент для определенных собраний, добавьте идентификатор пользовательского интерфейса собрания в items_by_id свойство . Инструкции по поиску идентификатора собрания см. в разделе Получение идентификатора собрания.

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

Связанные материалы

• Общие сведения о декларативных агентах
• Справочник по манифесту декларативного агента
• Добавление возможности интерпретатора кода в агент
• Добавление возможности генератора образов в агент