Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Совет
Рекомендуется: Начните с Work IQ Dev Tools для поддерживаемых сценариев декларативного агента и плагинов для кода. См. краткое руководство по WIQD. Инструкции на основе набора средств остаются доступными для существующих проектов и рабочих процессов, для которых они требуются. Перед выбором инструмента проверьте поддержку возможностей и целевого интерфейса : WIQD не нацелен на агентов пользовательской подсистемы.
Вы можете расширить возможности своего агента, добавив возможности или настраиваемые действия. Вы можете улучшить свой агент, включив встроенные функции, такие как генератор изображений или интерпретатор кода, либо добавив плагины MCP или API в качестве настраиваемых действий. В этом руководстве добавлен подключаемый модуль API. Сведения о добавлении сервера MCP см. в статьях Создание и повторное использование серверов MCP и Создание подключаемого модуля для декларативного агента из сервера MCP.
Важно
В этом руководстве предполагается, что вы завершили создание декларативных агентов с помощью набора инструментов агентов Microsoft 365 и руководства JSON .
Добавление генератора изображений в агент
Функция "Генератор изображений" позволяет агентам создавать изображения на основе запросов пользователей. Чтобы добавить генератор изображений:
appPackage/declarativeAgent.jsonОткройте файл и добавьтеGraphicArtзапись в массив.capabilitiesПодробнее см. в разделе Графический объект.{ "name": "GraphicArt" }На панели жизненного цикла набора средств агентов Microsoft 365 выберите "Подготовка".
Декларативный агент может создавать изображения после перезагрузки страницы.
Примечание
Генератор изображений недоступен для агентов в средах Microsoft 365 GCCH (GCCH).
Добавление интерпретатора кода в агент
Интерпретатор кода — это продвинутый инструмент, предназначенный для решения сложных задач с помощью кода Python.
Примечание
В средах GCCH интерпретатор кода доступен только пользователям с лицензией на надстройку Microsoft 365 Copilot.
appPackage/declarativeAgent.jsonОткройте файл и добавьтеCodeInterpreterзапись в массив.capabilities{ "name": "CodeInterpreter" }Дополнительные сведения см. в разделе Объект интерпретатора кода.
Выберите Подготовка в области жизненного цикла набора средств агентов.
Декларативный агент поддерживает интерпретатор кода после перезагрузки страницы.
Добавление подключаемого модуля API в качестве настраиваемого действия для агента
Подключаемые модули API добавляют новые возможности вашего агента, позволяя ему взаимодействовать с REST API.
Примечание
Настраиваемые действия не поддерживаются в средах GCCH.
Прежде чем начать, создайте файл с именем posts-api.yml и добавьте код из документа с описанием OpenAPI Posts.
Выберите команду "Добавить действие " в области разработки набора средств агентов.
Выберите «Начать с документа с описанием OpenAPI».
Нажмите "Обзор" и перейдите к нужному файлу
posts-api.yml.Выберите все доступные API и нажмите кнопку "ОК".
Выберите manifest.json.
Просмотрите предупреждение в диалоговом окне. Когда вы будете готовы продолжить, выберите "Добавить".
Выберите Подготовка в области жизненного цикла набора средств агентов.
Декларативный агент имеет доступ к содержимому подключаемого модуля для генерации ответов после перезагрузки страницы.
Описание API записей OpenAPI
Следующее описание OpenAPI предназначено для JSONPlaceHolder API, бесплатного онлайн-API REST, который вы можете использовать всякий раз, когда вам нужны поддельные данные.
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/user-id'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/user'
См. также:
Вы завершили работу над руководством по декларативному агенту для Microsoft 365 Copilot. Теперь, когда вы знакомы с возможностями декларативного агента, вы можете узнать больше о декларативных агентах в следующих статьях.
- Создание декларативных агентов с помощью набора средств для агентов Microsoft 365 и TypeSpec
- Узнайте, как написать эффективные инструкции для своего агента.
- Протестируйте агент в режиме разработчика, чтобы проверить, выбирает ли оркестратор Copilot источники знаний для использования в ответ на заданные запросы, и если да, то каким образом. Дополнительные сведения см. в статье Тестирование и отладка агентов в наборе средств агентов Microsoft 365 с помощью режима разработчика.
- Получите ответы на часто задаваемые вопросы.
- Узнайте о других способах создания декларативных агентов: no-code в Agent Builder или low-code в Copilot Studio.