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

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

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

Предварительные условия

Действия, описанные в этой статье, требуют наличия следующих предварительных требований:

  • Существующий декларативный агент, созданный с помощью microsoft 365 Agents Toolkit.

    Примечание.

    Агенты, созданные с помощью Microsoft 365 Copilot, в настоящее время не поддерживаются.

  • Пользовательский бот и идентификатор бота. Сведения о создании пользовательского бота см. в разделе Боты и агенты.

  • Visual Studio Code с установленным расширением Microsoft 365 Agents Toolkit.

  • Пакет SDK Пакет SDK агентов Microsoft 365 или Teams, если вы хотите реализовать функции, относящиеся к Copilot, например потоковую передачу или ссылки.

  • Разрешения на отправку манифестов приложений в вашей среде.

Преобразование декларативного агента

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

Обновление манифеста приложения

Чтобы обновить манифест приложения, выполните следующие действия:

  1. В Visual Studio Code откройте файл манифеста приложения для декларативного агента.

  2. Добавьте узел ботов и добавьте идентификатор бота в поле идентификатора . В следующем примере показана схема для узла ботов .

        "bots": [ 
        { 
            "botId": "${{BOT_ID}}", 
            "scopes": [ 
                "copilot", 
                "personal", 
                "team" 
            ], 
            "supportsFiles": false, 
            "isNotificationOnly": false, 
            "commandLists": [ 
                { 
                    "scopes": [ 
                        "copilot", 
                        "personal" 
                    ], 
                    "commands": [ 
                        { 
                            "title": "How can you help me?", 
                            "description": "How can you help me?" 
                        } 
                    ] 
                } 
            ] 
        } 
    ],

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

    Примечание.

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

  3. В объекте copilotAgents измените узел declarativeAgents на узел customEngineAgents , как показано в следующих примерах.

    Узел декларативных агентов

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

    Замена узлом настраиваемых агентов обработчика

    "copilotAgents": {
    "customEngineAgents": [
        {
            "type": "bot",
            "id": "${{BOT_ID}}"
        }
    ]
},
"bots": [
    { 
      "botId": "${{BOT_ID}}",
        "scopes": [
            "copilot",
            "personal",
            "team"
        ], 
        "supportsFiles": false,
        "isNotificationOnly": false,
        "commandLists": [
            {
                "scopes": [
                    "copilot",
                    "personal"
                ],
                "commands": [
                    {
                        "title": "How can you help me?",
                        "description": "How can you help me?"
                    }
                ]
            }
        ]
    }
],

    Справочные сведения о схеме см. в разделе Объект copilotAgents.

    Примечание.

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

  4. Обновите номер версии приложения в свойстве version .

  5. Убедитесь, что свойство id использует тот же идентификатор, который использовался в манифесте приложения для декларативного агента.

Настройка пользовательского интерфейса агента

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

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

Обновление и отправка пакета приложения

После обновления манифеста агента переупакуйте приложение:

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

  2. Отправьте новый пакет, чтобы обновить существующее приложение. Если агент является внутренним для вашей организации, используйте Центр администрирования Microsoft 365 (требуются разрешения администратора клиента).

    Примечание.

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

Настраиваемые агенты обработчика, преобразованные из декларативных агентов, можно отправлять в Центр партнеров для распространения с учетом применимых политик проверки Marketplace и политик клиента.

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

Пользователи видят запрос на обновление в Copilot и Teams и должны явно утвердить обновление. Требуется ли дополнительное утверждение администратора, зависит от запрошенных разрешений и конфигурации согласия клиента.

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

Взаимодействие с пользователем

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

Если пользователи закрепили агент, им нужно снова закрепить агент после публикации обновления.

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

  • Last updated on