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

2025-07-09

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

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

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

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

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

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

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

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

SharePoint и OneDrive

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

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

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

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

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

Важно!

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

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

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

Примечание.

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

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

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

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

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

Примечание.

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

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

Dataverse

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

Примечание.

Знания Dataverse в настоящее время недоступны в Copilot Studio построителе агентов.

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

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

Примечание.

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

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

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

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

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

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

Примечание.

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

Если вы используете набор средств агентов и 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-адрес общего почтового ящика.

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

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

Люди

Люди знания позволяют область агента, чтобы ответить на вопросы о людях в организации. Например, агент может отвечать на такие запросы, как "Разделы справки контактного <лица>" или "Перечисление прямых отчетов о человеке<>". Этот источник знаний не ограничен.

Примечание.

Люди знания в настоящее время недоступны в построителе агентов Copilot Studio.

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

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

Примечание.

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

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

Сообщения Teams

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

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

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

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

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

Примечание.

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

{
  "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, выполните следующие действия:

В Microsoft Teams перейдите к любому сообщению в чате.
Наведите указатель мыши на сообщение и выберите три точки (...).
Выберите Копировать ссылку.
Вставьте ссылку в Блокнот или аналогичное приложение. Ссылка будет выглядеть примерно так: 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.

Поделиться через

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

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

SharePoint и OneDrive

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

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

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

Dataverse

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

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

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

Люди

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

Сообщения Teams

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

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

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

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

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

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