Opublikuj agenta w centrum administracyjnym Microsoft

Użyj polecenia a365 publish, aby spakować swojego agenta, a następnie prześlij pakiet do centrum administracyjnego Microsoft 365. Po opublikowaniu możesz tworzyć instancje agentów w swojej organizacji i nimi zarządzać.

Wymagania wstępne

Zanim zaczniesz, upewnij się, że masz następującą konfigurację.

Wymagane konta i uprawnienia

  • Tenant Microsoft 365 z jedną z poniższych ról (wymagane w kroku przesyłania do Centrum administracyjnego):

    • Globalny administrator usługi

Wymagane narzędzia

Wymagane kroki konfiguracji

Przed publikacją wykonaj następujące kroki:

  1. Stwórz plan agenta – Postępuj zgodnie z etapem konfiguracji, aby stworzyć plan dla agenta.
  2. Testuj agenta lokalnie – upewnij się, że Twój agent działa prawidłowo, korzystając z Agents Playground (patrz Testowanie agentów lokalnie).
  3. Przygotuj pliki konfiguracyjne – upewnij się, że a365.config.json i a365.generated.config.json są aktualne.

Polecenie Publikuj

Uruchom a365 publishpolecenie:

a365 publish

Notatka

Uruchomienie a365 publish -h wyświetla wszystkie dostępne opcje, które obsługuje to polecenie.

Funkcje tego polecenia:

  1. Manifest aktualizacji – Aktualizacje manifest.json z ID blueprintu agenta.
  2. Utwórz pakiet - Pakiety manifest.json i ikony do manifest.zip.
  3. Wyświetl instrukcje - Wyświetla instrukcje krok po kroku dotyczące przesyłania za pomocą Centrum administracyjnego Microsoft 365.

Notatka

Polecenie a365 publish działa zarówno dla agentów, jak i AI współpracowników. Dla agentów utworzonych za pomocą --agent-name (config-free), upewnij się, że a365.generated.config.json istnieje w twoim katalogu roboczym przed uruchomieniem a365 publish, ponieważ polecenie pobiera identyfikator blueprintu z tego pliku.

Przekazywanie do centrum administracyjnego

Po zakończeniu a365 publish postępuj zgodnie z wyświetlonymi instrukcjami, aby przesłać swojego agenta:

  1. Przejdź do Centrum administracyjne Microsoft 365.
  2. Przejdź do Agenty>Wszystkie agenty.
  3. Wybierz pozycję Przekaż niestandardowego agent.
  4. Prześlij plik manifest.zip z folderu manifest w swoim projekcie.

Aby uzyskać więcej informacji, zobacz Przesyłanie agentów do Centrum administracyjnego platformy Microsoft 365.

Weryfikacja poprawności publikacji

Skorzystaj z poniższej listy kontrolnej, aby zweryfikować, czy Twój agent został pomyślnie opublikowany:

✅ Publikowanie CLI powiodło się
✅ manifest folder utworzony wraz z manifest.json i manifest.zip
✅ Agent jest widoczny w Centrum administracyjnym Microsoft

Dane wyjściowe w formacie CLI

Te komunikaty wyjściowe są wyświetlane, gdy polecenie publish zakończy się pomyślnie:

✅ Manifest updated successfully
✅ manifest.zip created successfully
✅ Instrukcje przesyłania krok po kroku drukowane

Jeśli polecenie się nie powiedzie, sprawdź komunikaty o błędach i upewnij się, że zakończyłeś konfigurację blueprintu.

Możliwe błędy:

Błąd Krok umożliwiający rozwiązanie problemu
Agent blueprint ID not found Uruchom a365 setup, aby zakończyć konfigurację blueprintów.
Permissions missing Uruchom ponownie konfigurację za pomocą a365 setup permissions polecenia.

Postępuj zgodnie z tymi krokami w przypadku niepowodzenia publikacji.

Pliki manifestów

Możesz przetestować następujące pliki w folderze manifest używając polecenia 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

Notatka

Jeśli nie widzisz tych plików, spróbuj ponownie uruchomić a365 publishpolecenie.

Agent pojawia się w centrum administracyjnym

Notatka

Po przesłaniu może minąć 5-10 minut, zanim agent pojawi się w centrum administracyjnym i Teams. To opóźnienie jest normalne.

Potwierdź, że agent jest obecny, wykonując następujące kroki:

  1. Przejdź do centrum administracyjnego Microsoft 365.
  2. Przejdź do Agenty>Wszystkie agenty.
  3. Twój agent widnieje na liście.

Poniższa tabela pokazuje, jakie informacje możesz znaleźć:

Pole Co należy sprawdzić?
Nazwa Nazwa agenta (z manifest.json)
Wersja Numer wersji (na przykład 1.0.0)
Wydawca Nazwa Twojej organizacji
Dostępność Dostępne/dla wszystkich użytkowników

Zobacz także

Następne kroki

Po opublikowaniu agenta utwórz instancję, aby móc ją skonfigurować i używać w swoim tenant.

Utworzenie instancji agenta

Rozwiązywanie problemów

Typowe problemy podczas publikowania agentów do Centrum administracyjnego Microsoft 365.

Wskazówka

Przewodnik po rozwiązywaniu problemów Agent 365 zawiera wysokopoziomowe zalecenia dotyczące rozwiązywania problemów, najlepsze praktyki oraz odnośniki do treści dotyczących rozwiązywania problemów dla każdego etapu cyklu rozwoju Agent 365.

Polecenie Publikuj kończy się niepowodzeniem

Objawy:

  • Błąd podczas a365 publish
  • manifest.zip nie został utworzony

Główna przyczyna:

  • Konfiguracja nie została zakończona
  • Błędy walidacji manifestu
  • Niewystarczające uprawnienia

Rozwiązanie:

  1. Sprawdź, czy instalacja została zakończona.

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

  2. Uruchom polecenie publish i postępuj zgodnie z monitami.

Przesyłanie nie powiodło się w centrum administracyjnym

Objawy:

  • Błąd podczas przesyłania manifest.zip w centrum administracyjnym Microsoft 365
  • Agent nie pojawia się po przesłaniu

Główna przyczyna:

  • Niewystarczające uprawnienia w centrum administracyjnym
  • Nieprawidłowe lub nieaktualne manifest.zip

Rozwiązanie:

  1. Upewnij się, że masz rolę Global Administrator.
  2. Uruchom a365 publish ponownie, aby wygenerować nowy manifest.zip.
  3. Spróbuj ponownie przesłać, postępując zgodnie z instrukcjami przesyłania.

Aby uzyskać więcej pomocy, zobacz Przesyłanie agentów do Centrum administracyjnego platformy Microsoft 365.

  • Last updated on