Агенты — это приложения для Microsoft 365

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

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

Пакет приложения

Пакет приложения для Microsoft 365, включая агенты, представляет собой ZIP-файл, содержащий один или несколько файлов конфигурации (манифеста) и значки вашего приложения. Логика приложения и хранилище данных размещаются в другом месте и получают доступ к ведущему приложению Microsoft 365 по протоколу HTTPS. Вы отправите пакет приложения администратору для публикации в организации или в Центр партнеров для публикации в Microsoft AppSource.

Как минимум, пакет приложения содержит:

• Манифест приложения (manifest.json), описывающий конфигурацию приложения, возможности, необходимые ресурсы и важные атрибуты.
• Большой значок цвета (color.png), полноцветный значок 92x92 для отображения агента в пользовательском интерфейсе Microsoft Copilot и хранения
• Небольшой значок контура (outline.png), значок 32x32 с прозрачным фоном (в настоящее время не используется в Copilot, но требуется для прохождения проверки)

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

Значки приложений

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

Рекомендации по проектированию цветных и контурных значков для пакета приложений Microsoft 365 см . в разделе Значки приложений для Магазина Teams и панели приложения.

Цветной значок

Значок цвета представляет вашего агента в пользовательском интерфейсе Microsoft Copilot и в магазинах приложений (Teams, Outlook, Microsoft 365).

Контурный значок

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

Манифест приложения

Манифест приложения для Microsoft 365 представляет собой JSON-файл, в котором описываются функции и характеристики приложения. По своей сути манифест приложения для Microsoft 365 — это схема для создания приложений Teams; однако, начиная с версии 1.13, она поддерживает приложения, которые работают на узлах Microsoft 365, в дополнение к Teams.

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

Каждый манифест приложения должен содержать следующие поля.

В следующем примере показан манифест приложения с заполнителями в конце для расширения сообщений и возможностей приложения декларативного агента.

{
    "$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.18/MicrosoftTeams.schema.json",
    "manifestVersion": "1.18",
    "version": "1.0.0",
    "id": "00000000-0000-0000-0000-000000000000",
    "developer": {
        "name": "Northwind Traders",
        "websiteUrl": "https://www.example.com",
        "privacyUrl": "https://www.example.com/termofuse",
        "termsOfUseUrl": "https://www.example.com/privacy"
    },
    "icons": {
        "color": "Northwind-Logo-196.png",
        "outline": "Northwind-Logo-32.png"
    },
    "name": {
        "short": "Northwind Inventory",
        "full": "Northwind Inventory App"
    },
    "description": {
        "short": "App allows you to find and update product inventory information",
        "full": "Northwind Inventory is the ultimate tool for managing your product inventory. With its intuitive interface and powerful features, you'll be able to easily find your products by name, category, inventory status, and supplier city. You can also update inventory information with the app."
    },
    "accentColor": "#3690E9",
    "composeExtensions": {
        ...
    },
    "copilotAgents": {
        ...
    }
}

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

copilotAgents Определения

Декларативные агенты и подключаемые модули API имеют собственные схемы определений. На файл определения декларативного агента ссылается copilotAgents объект манифеста приложения.

В следующем примере показано, как ссылаться на декларативный агент:

    "copilotAgents": {
        "declarativeAgents": [
            {
                "id": "agent1",
                "file": "declarativeAgent1.json"
            }
        ]
    },

На определение подключаемого модуля API ссылается (в разделе actions) из определения декларативного агента.

Обратите внимание на следующее:

• В настоящее время поддерживается только одно декларативное определение агента для каждого манифеста приложения.

• При использовании Copilot Studio для создания агентов для каждого из них создается уникальный id объект в рамках общего создания манифеста приложения. При создании агентов с помощью Набора средств Teams или собственной интегрированной среды разработки вы назначаете id сами в соответствии с вашими соглашениями или понятным именем.

Манифест декларативного агента

Манифест декларативного агента содержит инструкции для ответов Copilot, примеры запросов для начала беседы, источники данных, используемые для заземления, а также список действий (навыки подключаемого модуля API), которые агент может выполнить.

Дополнительные сведения см. в статье Схема манифеста декларативного агента для Microsoft 365 Copilot.

Манифест подключаемого модуля API

Манифест подключаемого модуля API описывает возможности подключаемого модуля, включая поддерживаемые им API и операции, которые он может выполнять. Он также содержит метаданные, такие как имя, описание, версия, а также ссылку на определение OpenAPI интерфейсов REST API, с которыми он взаимодействует. На подключаемые модули API можно ссылаться из манифеста декларативного агента, который будет использоваться в интерфейсе декларативного агента.

Дополнительные сведения см. в статье Схема манифеста подключаемого модуля API для Microsoft 365 Copilot.

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

• Локализация агента
• Управление расширяемостью для Microsoft 365 Copilot
• Публикация агентов для Microsoft 365 Copilot