Агент публикации в административный центр Microsoft

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

Предпосылки

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

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

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

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

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

  • Установлен интерфейс командной строки A365 (интерфейс командной строкиагента 365)

Необходимые действия по настройке

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

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

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

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

a365 publish

Note

Запуск a365 publish -h показывает все опции, которые поддерживает эта команда.

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

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

Note

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

Загрузка в административный центр

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

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

Для получения дополнительной информации см. Upload агентов на Центр администрирования 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 папке, используя команду Test-Path PowerShell.

# 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

Note

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

Агент появляется в административном центре

Note

После загрузки может потребоваться 5-10 минут, чтобы агент появился в административном центре и Teams. Такая задержка — нормально.

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

  1. Перейдите в центр администрирования Microsoft 365.
  2. Перейдите в раздел «Агенты>все агенты».
  3. Ваш агент появляется в списке.

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

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

См. также

Дальнейшие шаги

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

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

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

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

Tip

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

Команда «Публикация» не работает

Симптомы:

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

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

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

Solution:

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

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

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

Загрузка не удаётся в административном центре

Симптомы:

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

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

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

Solution:

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

Для получения дополнительной информации смотрите Upload агентов на Центр администрирования Microsoft 365.

  • Last updated on