Создание декларативных агентов с помощью Набора средств Teams
Декларативный агент — это настраиваемая версия Microsoft 365 Copilot, которая позволяет пользователям создавать персонализированные интерфейсы путем объявления конкретных инструкций, действий и знаний. В этом руководстве содержатся сведения о создании декларативного агента с помощью набора средств Teams.
Агент, который вы создаете в этом руководстве, предназначен для лицензированных Microsoft 365 Copilot пользователей. Кроме того, можно создавать агенты для Microsoft 365 Copilot Chat пользователей с ограниченными возможностями. Дополнительные сведения см. в разделе Возможности агента для пользователей Microsoft 365.
Общие сведения см. в разделе Декларативные агенты для Microsoft 365 Copilot.
Примечание.
Декларативные агенты на основе Microsoft 365 Copilot теперь поддерживаются в Word и PowerPoint.
Предварительные условия
Перед началом работы убедитесь, что Microsoft 365 Copilot доступны для вашей организации.
Для вашей среды разработки доступны следующие параметры:
- Песочница организации Microsoft 365 с Copilot (доступна в ограниченной предварительной версии благодаря членству в TAP).
- Рабочая среда Microsoft 365 или Office 365 с лицензией на Microsoft 365 Copilot.
Для выполнения действий, описанных в этой статье, требуются следующие ресурсы:
- Расширение набора средств Teams Visual Studio Code версии 5.14.0 или более поздней
- Расширение kiota Visual Studio Code версии 1.19.1000000002 или более поздней
Примечание.
Снимки экрана и ссылки на пользовательский интерфейс набора средств Teams в этом документе были созданы с помощью последней версии выпуска 5.14.0. Предварительные версии Набора средств Teams могут отличаться от пользовательского интерфейса в этом документе.
Необходимо ознакомиться со следующими стандартами и рекомендациями для декларативных агентов для Microsoft 365 Copilot:
- Стандарты соответствия требованиям, производительности, безопасности и пользовательского интерфейса, описанные в руководстве по проверке Магазина Teams.
Создание декларативного агента
Начните с создания базового декларативного агента.
Откройте Visual Studio Code.
Выберите Набор средств > Teams Создать новое приложение.
Выберите Декларативный агент.
Выберите Нет действий , чтобы создать базовый декларативный агент.
Выберите Папка по умолчанию , чтобы сохранить корневую папку проекта в расположении по умолчанию.
Введите
My Agentимя приложения и нажмите клавишу ВВОД.В открывавшемся окне нового Visual Studio Code выберите Набор средств Teams, а затем в области Жизненный цикл выберите Подготовка.
Тестирование агента
Перейдите к приложению Copilot с URL-адресом https://m365.cloud.microsoft/chat.
Рядом с кнопкой Создать чат выберите значок ящика беседы.
Выберите декларативный агент Мой агент.
Введите вопрос для декларативного агента и убедитесь, что он ответит "Спасибо за использование Набора средств Teams для создания декларативного агента!"
Добавление инструкций
В этом разделе вы добавите инструкции для агента по изменению его поведения.
Откройте файл и замените
appPackage/instructions.txtего содержимое следующим текстом.You are a declarative agent and were created with Team Toolkit. You are an expert at creating poems. Every time a user asks a question, you **must** turn the answer into a poem. The poem **must** not use the quote markdown and use regular text.Содержимое этого файла вставляется в
instructionsсвойство в манифесте агента во время подготовки. Дополнительные сведения см. в разделе Объект манифеста декларативного агента.Выберите Подготовить в области Жизненный цикл набора средств Teams.
После перезагрузки страницы декларативный агент будет использовать обновленные инструкции.
Добавление начальных общения
В этом разделе описано, как добавить в агент начальную беседу. Начальные параметры общения — это подсказки, которые отображаются пользователю, чтобы продемонстрировать, как приступить к работе с декларативным агентом.
appPackage/declarativeAgent.jsonОткройте файл и добавьтеconversation_startersмассив со следующим содержимым:"conversation_starters": [ { "title": "Getting Started", "text": "How can I get started with Teams Toolkit?" }, { "title": "Getting Help", "text": "How can I get help with Teams Toolkit?" } ]Дополнительные сведения см. в разделе Начальный объект Conversation.
Выберите Подготовить в области Жизненный цикл набора средств Teams.
Обновленные начальные параметры диалога будут доступны в декларативном агенте после обновления страницы.
Добавление веб-содержимого
В этом разделе вы добавите возможность поиска в Интернете в агент.
appPackage/declarativeAgent.jsonОткройте файл и добавьтеcapabilitiesмассив со следующим содержимым."capabilities": [ { "name": "WebSearch" } ]Дополнительные сведения см. в разделе Объект веб-поиска.
Выберите Подготовить в области Жизненный цикл набора средств Teams.
После перезагрузки страницы декларативный агент получит доступ к веб-содержимому для создания ответов.
Добавление содержимого OneDrive и SharePoint
В этом разделе вы добавите содержимое сайта SharePoint в доступные знания для агента.
appPackage/declarativeAgent.jsonОткройте файл и обновитеcapabilitiesмассив до следующего значения, заменивhttps://contoso.sharepoint.com/sites/ProductSupportURL-адресом сайта SharePoint в организации Microsoft 365."capabilities": [ { "name": "WebSearch" }, { "name": "OneDriveAndSharePoint", "items_by_url": [ { "url": "https://contoso.sharepoint.com/sites/ProductSupport" } ] } ]Дополнительные сведения см. в статье OneDrive и объект SharePoint.
Примечание.
- URL-адреса должны содержать полный путь к элементам SharePoint (сайту, библиотеке документов, папке или файлу). Вы можете использовать параметр "Копировать прямую ссылку" в SharePoint, чтобы получить полный путь или файлы и папки. Для этого щелкните правой кнопкой мыши файл или папку и выберите Пункт Сведения. Перейдите в раздел Путь и щелкните значок копирования.
- Если не указать
items_by_urlмассив (или альтернативныйitems_by_sharepoint_idsмассив), все содержимое OneDrive и SharePoint в организации Microsoft 365, доступное для вошедшего пользователя, станет доступным агенту.
Выберите Подготовить в области Жизненный цикл набора средств Teams.
После перезагрузки страницы декларативный агент получит доступ к содержимому OneDrive и SharePoint, чтобы создать ответы.
Добавление содержимого соединителей Microsoft Graph
В этом разделе описано, как добавить элементы, принятые соединителем Microsoft Graph, в доступные знания для агента.
appPackage/declarativeAgent.jsonОткройте файл и обновитеcapabilitiesмассив до следующего значения, заменив допустимым идентификатором соединителяpolicieslocalMicrosoft Graph в организации Microsoft 365. Дополнительные сведения о поиске идентификаторов соединителей Microsoft Graph см. в разделе Извлечение идентификаторов возможностей для декларативного манифеста агента."capabilities": [ { "name": "WebSearch" }, { "name": "OneDriveAndSharePoint", "items_by_url": [ { "url": "https://contoso.sharepoint.com/sites/ProductSupport" } ] }, { "name": "GraphConnectors", "connections": [ { "connection_id": "policieslocal" } ] } ]Дополнительные сведения см. в разделе Объект соединителей Microsoft Graph.
Примечание.
- Если не указать
connectionsмассив, все содержимое соединителей Microsoft Graph в организации Microsoft 365, доступное для вошедшего в систему пользователя, станет доступным агенту.
- Если не указать
Выберите Подготовить в области Жизненный цикл набора средств Teams.
Декларативный агент будет иметь доступ к содержимому соединителей Microsoft Graph, чтобы создать ответы после перезагрузки страницы.
Добавление подключаемых модулей API
В этом разделе вы добавите подключаемый модуль API в качестве действия в агент. Подключаемые модули API добавляют новые возможности агента, позволяя агенту взаимодействовать с REST API.
Вы можете добавить подключаемый модуль к агенту с помощью набора средств Teams или расширения Kiota Visual Studio Code.
Прежде чем приступить к работе, создайте файл с именем posts-api.yml и добавьте код из документа описание API публикации OpenAPI.
Выберите Добавить действие в области Разработка набора средств Teams.
Выберите Начать с документа описания OpenAPI.
Выберите Обзор и перейдите к файлу
posts-api.yml.Выберите все доступные API, а затем нажмите кнопку ОК.
Выберите manifest.json.
Просмотрите предупреждение в диалоговом окне. Когда вы будете готовы продолжить, нажмите кнопку Добавить.
Выберите Подготовить в области Жизненный цикл набора средств Teams.
Декларативный агент будет иметь доступ к содержимому подключаемого модуля для создания ответов после перезагрузки страницы.
Документ описания API OpenAPI для публикации
Следующее описание OpenAPI предназначено для API JSONPlaceHolder— бесплатного REST API, который можно использовать всякий раз, когда вам нужны поддельные данные.
openapi: '3.0.2'
info:
title: Posts API
version: '1.0'
servers:
- url: https://jsonplaceholder.typicode.com/
components:
schemas:
post:
type: object
properties:
userId:
type: integer
description: The ID of the user that authored the post.
id:
type: integer
title:
type: string
body:
type: string
user:
type: object
properties:
id:
type: integer
name:
type: string
username:
type: string
email:
type: string
phone:
type: string
website:
type: string
address:
$ref: '#/components/schemas/address'
company:
$ref: '#/components/schemas/company'
address:
type: object
properties:
street:
type: string
suite:
type: string
city:
type: string
zipcode:
type: string
geo:
$ref: '#/components/schemas/coordinates'
coordinates:
type: object
properties:
lat:
type: string
description: The latitude of the location
lng:
type: string
description: The longitude of the location
company:
type: object
properties:
name:
type: string
catchPhrase:
type: string
bs:
type: string
parameters:
post-id:
name: post-id
in: path
description: 'key: id of post'
required: true
style: simple
schema:
type: integer
user-id:
name: user-id
in: path
description: 'key: id of user'
required: true
style: simple
schema:
type: integer
paths:
/posts:
get:
description: Get posts
operationId: GetPosts
parameters:
- name: userId
in: query
description: Filter results by user ID
required: false
style: form
schema:
type: integer
maxItems: 1
- name: title
in: query
description: Filter results by title
required: false
style: form
schema:
type: string
maxItems: 1
responses:
'200':
description: OK
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/post'
post:
description: 'Create post'
operationId: CreatePost
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/post'
responses:
'201':
description: Created
content:
application/json:
schema:
$ref: '#/components/schemas/post'
/posts/{post-id}:
get:
description: 'Get post by ID'
operationId: GetPostById
parameters:
- $ref: '#/components/parameters/post-id'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/post'
patch:
description: 'Update post'
operationId: UpdatePost
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/post'
parameters:
- $ref: '#/components/parameters/post-id'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/post'
delete:
description: 'Delete post'
operationId: DeletePost
parameters:
- $ref: '#/components/parameters/post-id'
responses:
'200':
description: OK
/users:
get:
summary: Get users
description: Returns details about users
operationId: GetUsers
parameters:
- name: name
in: query
description: The user's real name
schema:
type: string
- name: username
in: query
description: The user's login name
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/user'
/users/{user-id}:
get:
description: 'Get user by ID'
operationId: GetUserById
parameters:
- $ref: '#/components/parameters/post-id'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/user'
Поздравляем!
Вы завершили декларативное руководство по агенту для Microsoft 365 Copilot. Теперь, когда вы знакомы с возможностями декларативного агента, вы можете узнать больше о декларативных агентах в следующих статьях.
- Узнайте, как написать эффективные инструкции для агента.
- Получите ответы на часто задаваемые вопросы.
- Узнайте об альтернативном методе создания декларативных агентов с Copilot Studio построитель агентов.
Возникла проблема с этим разделом? Если это так, отправьте нам отзыв, чтобы мы исправили этот раздел.