Добавление возможностей и настраиваемых действий в декларативный агент, созданный с помощью набора средств агентов Microsoft 365

Совет

Рекомендуется: Начните с Work IQ Dev Tools для поддерживаемых сценариев декларативного агента и плагинов для кода. См. краткое руководство по WIQD. Инструкции на основе набора средств остаются доступными для существующих проектов и рабочих процессов, для которых они требуются. Перед выбором инструмента проверьте поддержку возможностей и целевого интерфейса : WIQD не нацелен на агентов пользовательской подсистемы.

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

Важно

В этом руководстве предполагается, что вы завершили создание декларативных агентов с помощью набора инструментов агентов Microsoft 365 и руководства JSON .

Добавление генератора изображений в агент

Функция "Генератор изображений" позволяет агентам создавать изображения на основе запросов пользователей. Чтобы добавить генератор изображений:

  1. appPackage/declarativeAgent.json Откройте файл и добавьте GraphicArt запись в массив.capabilities Подробнее см. в разделе Графический объект.

    {
      "name": "GraphicArt"
    }
    
  2. На панели жизненного цикла набора средств агентов Microsoft 365 выберите "Подготовка".

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

Примечание

Генератор изображений недоступен для агентов в средах Microsoft 365 GCCH (GCCH).

Снимок экрана: ответ декларативного агента, содержащий сгенерированную графическую картинку

Добавление интерпретатора кода в агент

Интерпретатор кода — это продвинутый инструмент, предназначенный для решения сложных задач с помощью кода Python.

Примечание

В средах GCCH интерпретатор кода доступен только пользователям с лицензией на надстройку Microsoft 365 Copilot.

  1. appPackage/declarativeAgent.json Откройте файл и добавьте CodeInterpreter запись в массив.capabilities

    {
      "name": "CodeInterpreter"
    }
    

    Дополнительные сведения см. в разделе Объект интерпретатора кода.

  2. Выберите Подготовка в области жизненного цикла набора средств агентов.

Декларативный агент поддерживает интерпретатор кода после перезагрузки страницы.

Снимок экрана: ответ декларативного агента, содержащий созданный график

На этом снимке экрана показан код Python, используемый для создания запрошенного графа

Добавление подключаемого модуля API в качестве настраиваемого действия для агента

Подключаемые модули API добавляют новые возможности вашего агента, позволяя ему взаимодействовать с REST API.

Примечание

Настраиваемые действия не поддерживаются в средах GCCH.

Прежде чем начать, создайте файл с именем posts-api.yml и добавьте код из документа с описанием OpenAPI Posts.

  1. Выберите команду "Добавить действие " в области разработки набора средств агентов.

  2. Выберите «Начать с документа с описанием OpenAPI».

  3. Нажмите "Обзор" и перейдите к нужному файлуposts-api.yml.

  4. Выберите все доступные API и нажмите кнопку "ОК".

    Снимок экрана: диалоговое окно выбора API в Visual Studio Code

  5. Выберите manifest.json.

  6. Просмотрите предупреждение в диалоговом окне. Когда вы будете готовы продолжить, выберите "Добавить".

  7. Выберите Подготовка в области жизненного цикла набора средств агентов.

Декларативный агент имеет доступ к содержимому подключаемого модуля для генерации ответов после перезагрузки страницы.

Снимок экрана, показывающий ответ декларативного агента, содержащий содержимое подключаемого модуля API

Описание 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. Теперь, когда вы знакомы с возможностями декларативного агента, вы можете узнать больше о декларативных агентах в следующих статьях.