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

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

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

Возможность или источник знаний	Построитель агентов	Набор средств для агентов	Требуется лицензия или лимитное использование?
Интерпретатор кода	✅	✅	Нет
Генератор изображений	✅	✅	Нет
Соединители Copilot	✅	✅	Да
SharePoint	✅	✅	Да
OneDrive	✅	✅	Да
Содержимое внедренных файлов	✅	❌	Да
Поиск в Интернете	✅	✅	Нет
Заданный поиск в Интернете	✅	✅	Нет
Dataverse	✅	✅*	Да
Электронная почта	✅	✅*	Да (только лицензия)
Люди	✅	✅	Да (только лицензия)
Страницы OneNote	✅	❌	Нет
Сообщения Teams	✅	✅*	Да (только лицензия)
Собрания Teams	✅	✅	Да (только лицензия)

* Доступна возможность областей знаний.

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

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

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

Сведения о том, как добавить соединители Copilot в агент в Построителе агентов, см. в разделе Соединители Copilot.

SharePoint и OneDrive

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

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

Сведения о том, как добавить знания SharePoint и OneDrive в агент в построителе агентов, а также об ограничениях на количество агентов и об обработке разрешений и меток конфиденциальности см. в статье Материалы SharePoint и OneDrive.

Примечание.

Источники знаний SharePoint и OneDrive требуют, чтобы у вошедшего пользователя была активная лицензия на Microsoft 365 Copilot. Если у пользователя нет лицензии, запросы завершаются сбоем с сообщением К сожалению, не удалось ответить.

Учетные записи клиентов цифрового взаимодействия с клиентами (CDX) без лицензии Copilot могут публиковать агентов, но не могут выполнять извлечение на основе SharePoint. Используйте лицензию разработчика Microsoft 365 Copilot для тестирования сценариев в непроизводственных средах.

Веб-поиск и область веб-поиска

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

Важно!

Администраторы организации могут отключить веб-поиск для Copilot и всех агентов внутри организации. Если администраторы отключили поиск в Интернете, агенты с включенным поиском в Интернете не сообщают об ошибках и не включают в свои сведения поисковые запросы в Интернете. Карточки отладки режима разработчика указывают, что веб-поиск включен, если он включен агентом, даже если он отключен администраторами. Подробнее см. в статье Управление сценариями Microsoft 365 Copilot в Центре администрирования Microsoft 365.

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

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

Примечание.

Чтобы добавить в агент веб-поиск с заданной областью поиска, используйте схему манифеста декларативного агента версии 1.3 или более поздней.

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

Если вы используете Agent Builder для создания агента, на вкладке "Настройка " в разделе "Знания" перечислите URL-адреса веб-сайтов, на которые нужно ссылаться.

Граундинг веб-поиска и динамическое содержимое

Если манифест декларативного агента ограничивает веб-поиск определенными URL-адресами веб-сайтов, агент основывает свои ответы на содержимом, индексируемом Bing для этих сайтов, а не на прямом доступе к базовому источнику данных.

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

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

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

Чтобы напрямую получить доступ к структурированному, часто меняющемуся контенту, используйте плагин API на основе спецификации OpenAPI вместо ограниченного веб-поиска. Подключаемый модуль API позволяет агенту напрямую запрашивать базовый источник данных и использовать параметры API, такие как сортировка и ограничения результатов, вместо того, чтобы полагаться на индексированное веб-содержимое. Кроме того, можно перенести содержимое в поддерживаемый источник знаний на основе OpenAPI или статический. Рекомендации по этим подходам см. в разделе:

Содержимое внедренных файлов

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

Примечание.

Функция отправки файлов доступна пользователям с включенным выставлением счетов за использование или с лицензией Microsoft 365 Copilot.
Содержимое внедренных файлов не поддерживается в средах Microsoft 365 GCC (облако сообщества для государственных организаций).

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

Важно!

Информационные барьеры Microsoft Purview (IB) не поддерживаются для внедренных файлов. Любой пользователь, имеющий доступ к агенту, может видеть ответы, основанные на содержимом внедренного файла.

Dataverse

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

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

Если для создания агента вы используете Agent Builder, выберите Dynamics 365 и Power Apps на вкладке "Настройка" в разделе "Знания". Выберите + , чтобы найти нужное приложение и выберите его, или оставьте все как есть, чтобы выполнить поиск по всем приложениям. Вы можете получить доступ к знаниям Dataverse в Agent Builder через бизнес-приложения в Work IQ, которые администратор должен сначала включить.

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

Примечание.

Чтобы расширить Dataverse набор знаний, используйте схему манифеста декларативного агента версии 1.3 или более поздней.

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

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

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

Чтобы получить или создать значение Dataverse skill :

Получите идентификатор организации на портале >создателя Power Appsв разделе параметров>ресурсов для разработчиков.
Получение маркера носителя для проверки подлинности и создания ресурсов 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"
```

Определите, существует ли уже значение, 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":[]
}

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

Запрос

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

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

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

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

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

Если вы используете Agent Builder для создания агента, на вкладке "Настройка " в разделе "Знания " выберите " Мои электронные письма".

Примечание.

В настоящее время при использовании Agent Builder невозможно область сообщения электронной почты в определенную папку или общий почтовый ящик.

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

Примечание.

Для добавления Email знаний необходимо использовать схему манифеста декларативного агента версии 1.3 или более поздней.

{
  "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, к которым должен быть связан агент.

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

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

Люди

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

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

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

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

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

Примечание.

Чтобы добавить People источник знаний (без связанного содержимого), используйте схему манифеста декларативного агента версии 1.3 или более поздней. Чтобы использовать свойство include_related_content , используйте версию 1.6 или более позднюю.

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

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

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

Страницы OneNote

При использовании Microsoft 365 Copilot для создания агента вы можете выбрать определенные страницы OneNote в средстве выбора файлов для отправки в качестве знаний. Можно выбрать только отдельные страницы OneNote. Возможность выбрать записную книжку OneNote целиком недоступна.

Используйте средство выбора файлов для добавления страниц OneNote. Построитель агентов не поддерживает ввод URL-адресов страниц OneNote.

Сообщения Teams

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

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

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

Если вы используете Agent Builder для создания агента, на вкладке "Настройка " в разделе "Знания " щелкните строку поиска и выберите "Мои чаты и собрания Teams". Чтобы ограничить область действия агента определенным каналом, собранием или групповым область, на вкладке «Чаты» выберите чаты, которые необходимо добавить в качестве знаний.

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

Примечание.

Для добавления TeamsMessage источника знаний необходимо использовать схему манифеста декларативного агента версии 1.3 или более поздней.

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

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

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

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

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

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

Чтобы получить значение chatId для группы или личного чата:

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

Примечание.

Ссылки на ряд собраний ограничены последними четырьмя экземплярами ряда.

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

Если вы используете Agent Builder для создания агента, на вкладке "Настройка " в разделе "Знания " щелкните строку поиска и выберите "Мои чаты и собрания Teams". В ближайшее время в Agent Builder появится возможность определения областей до собраний.

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

Примечание.

Для добавления Meetings источника знаний необходимо использовать схему манифеста декларативного агента версии 1.6 или более поздней.

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

Обратная связь

Были ли сведения на этой странице полезными?

Последнее обновление: 2026-09-30

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

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

SharePoint и OneDrive

Веб-поиск и область веб-поиска

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

Граундинг веб-поиска и динамическое содержимое

Содержимое внедренных файлов

Dataverse

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

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

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

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

Люди

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

Страницы OneNote

Сообщения Teams

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

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

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

Собрания Teams

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

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

Обратная связь

Дополнительные ресурсы