Публикация агента в Центре администрирования Microsoft

Используйте команду a365 publish для создания пакета агента, а затем загрузите этот пакет в Центр администрирования Microsoft 365. После публикации вы можете создавать экземпляры агента внутри своей организации и управлять ими.

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

Прежде чем начать, убедитесь, что у вас есть следующее.

Необходимые учетные записи и разрешения

  • Арендатор Microsoft 365 с одной из следующих ролей (необходимой для загрузки в Центр администрирования):

    • Глобальный администратор

Необходимые средства

Обязательные этапы настройки

Перед публикацией выполните следующие действия:

  1. Создание схемы агента — выполните шаг настройки, чтобы создать схему агента.
  2. Локальное тестирование агента — убедитесь, что ваш агент работает корректно с помощью Agents Playground (см. Локальное тестирование агентов).
  3. Подготовка файлов конфигурации — убедитесь, что a365.config.json и a365.generated.config.json актуальны.

Команда публикации

Выполните команду a365 publish:

a365 publish

Примечание

При выполнении a365 publish -h отображаются все параметры, которые поддерживает эта команда.

Что делает эта команда:

  1. Обновляет манифест — записывает в manifest.json идентификатор схемы агента.
  2. Создает пакет — упаковывает manifest.json и значки в manifest.zip.
  3. Выводит инструкции — отображает пошаговые инструкции по отправке через Центр администрирования Microsoft 365.

Примечание

Команда a365 publish работает как для агентов, так и для ИИ-коллег. Для агентов, подготовленных с помощью --agent-name (без конфигурации), перед выполнением a365 publish убедитесь, что a365.generated.config.json присутствует в вашем рабочем каталоге, так как команда считывает идентификатор схемы из этого файла.

Отправка в центр администрирования

После завершения a365 publish следуйте выведенным инструкциям для отправки вашего агента:

  1. Перейти в центр администрирования Microsoft 365.
  2. Выберите Агенты>Все агенты.
  3. Выберите Отправить пользовательского агента.
  4. Отправьте файл manifest.zip из папки manifest в вашем проекте.

Дополнительные сведения см. в разделе Отправка агентов в центр администрирования Microsoft 365.

Проверка успешности публикации

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

✅ CLI-публикация завершается успешно
✅ Создана папка manifest с manifest.json и manifest.zip
✅ Агент отображается в центре администрирования Microsoft

Выходные данные CLI

При успешном выполнении команды publish вы увидите следующие выходные сообщения:

✅ Manifest updated successfully
✅ manifest.zip created successfully
✅ Пошаговые инструкции по отправке выведены

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

Возможные ошибки:

Ошибка Устранение
Agent blueprint ID not found Выполните a365 setup для завершения настройки схемы.
Permissions missing Повторно выполните настройку с помощью командыa365 setup permissions.

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

Файлы манифеста

Вы можете проверить следующие файлы в папке manifest, используя команду PowerShell Test-Path.

# Check manifest folder and contents exists
Test-Path <deploymentProjectPath>/manifest/
Test-Path <deploymentProjectPath>/manifest/manifest.json
Test-Path <deploymentProjectPath>/manifest/manifest.zip
# All should return: True

Примечание

Если эти файлы не отображаются, попробуйте выполнить команду a365 publish еще раз.

Агент отображается в центре администрирования

Примечание

После отправки может пройти 5–10 минут, прежде чем ваш агент появится в центре администрирования и в Teams. Это нормально.

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

  1. Перейдите к Центру администрирования Microsoft 365.
  2. Выберите Агенты>Все агенты.
  3. Ваш агент отображается в списке.

В следующей таблице показано, какую информацию можно найти:

Поле Что проверить
Имя Имя вашего агента (из manifest.json)
Версия Номер версии (например, 1.0.0)
Издатель Название вашей организации
Доступность Доступно/Все пользователи

См. также

Следующие шаги

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

Создание экземпляра агента

Устранение неполадок

Распространенные проблемы при публикации агентов в Центре администрирования Microsoft 365.

Совет

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

Сбой команды публикации

Симптомы:

  • Ошибка при a365 publish
  • manifest.zip не создается

Первопричины:

  • Настройка не завершена
  • Ошибки валидации манифеста
  • Недостаточно разрешений

Решение:

  1. Убедитесь, что настройка завершена.

    Get-Content a365.generated.config.json | ConvertFrom-Json | Select-Object agentBlueprintId

  2. Выполните команду publish и следуйте инструкциям.

Отправка завершается сбоем в центре администрирования

Симптомы:

  • Ошибка при отправке manifest.zip в Центр администрирования Microsoft 365
  • Агент не появляется после загрузки

Первопричины:

  • Недостаточные разрешения в центре администрирования
  • Недействительный или устаревший manifest.zip

Решение:

  1. Убедитесь, что у вас есть роль глобального администратора.
  2. Выполните a365 publishеще раз, чтобы сгенерировать новый manifest.zip.
  3. Повторите отправку, следуя инструкциям по отправке.

Дополнительные сведения см. в разделе Отправка агентов в центр администрирования Microsoft 365.

  • Last updated on