Udostępnij za pośrednictwem

Dokumentacja poleceń interfejsu wiersza polecenia setup agenta 365

Ważne

Aby uzyskać wczesny dostęp do programu Microsoft Agent 365, musisz być częścią programu Frontier w wersji zapoznawczej. Usługa Frontier łączy Cię bezpośrednio z najnowszymi innowacjami firmy Microsoft dotyczącymi sztucznej inteligencji. Wersje zapoznawcze platformy Frontier podlegają istniejącym warunkom obowiązywania wersji zapoznawczej umów klienta. Ponieważ te funkcje są nadal opracowywane, ich dostępność i możliwości mogą ulec zmianie w miarę upływu czasu.

Skonfiguruj środowisko agenta 365 z szczegółową kontrolą nad każdym krokiem. To polecenie zarządza początkowym przepływem pracy konfiguracji dla strategii agenta 365.

wymagana rola Minimum: Azure Współautor + Global Administrator

Składnia

a365 setup [command] [options]

Opcje

Option Description
-?, , -h--help Wyświetla informacje pomocy i użycia. 
# 0. Check prerequisites (optional)
a365 setup requirements

# 1. Create infrastructure (or skip if infrastructure exists)
a365 setup infrastructure

# 2. Create blueprint
a365 setup blueprint

# 3. Configure MCP permissions
a365 setup permissions mcp

# 4. Configure bot permissions
a365 setup permissions bot

# 5. Configure CopilotStudio permissions (if needed)
a365 setup permissions copilotstudio

# 6. Configure custom permissions (if needed)
a365 setup permissions custom

Możesz też uruchomić wszystkie kroki jednocześnie:

# Full setup (includes infrastructure)
a365 setup all

# Skip infrastructure if it already exists
a365 setup all --skip-infrastructure

setup requirements

Zweryfikuj wymagania wstępne dotyczące konfiguracji agenta 365. Uruchamia modułowe kontrole wymagań i zawiera wskazówki dotyczące wszelkich napotkanych problemów.

a365 setup requirements [options]

To polecenie uruchamia następujące kroki:

  • Sprawdza wszystkie wymagania wstępne wymagane do skonfigurowania agenta 365.
  • Zgłasza wszelkie problemy ze szczegółowymi wskazówkami dotyczącymi rozwiązywania problemów.
  • Kontynuuje sprawdzanie wszystkich wymagań, nawet jeśli niektóre testy kończą się niepowodzeniem.
  • Zawiera podsumowanie wszystkich kontroli na końcu.

requirements Opcje

Option Description
-c, --config <config> Ścieżka pliku konfiguracji. Wartość domyślna to a365.config.json.
-v, --verbose Przedstawia szczegółowe dane wyjściowe dla wszystkich kontroli.
--category <category> Uruchamia kontrole tylko dla określonej kategorii, na przykład Azure, Authentication lub Configuration.
-?, , -h--help Wyświetla informacje pomocy i użycia.

setup infrastructure

Tworzenie infrastruktury Azure.

Minimum wymagane uprawnienia: współautor subskrypcji Azure lub właściciel

a365 setup infrastructure [options]

infrastructure Opcje

Option Description
-c, --config <config> Ścieżka pliku konfiguracji. Wartość domyślna to a365.config.json.
-v, --verbose Pokaż szczegółowe dane wyjściowe.
--dry-run Pokaż, co można zrobić bez wykonywania.
-?, , -h--help Wyświetla informacje pomocy i użycia.

setup blueprint

Utwórz strategię agenta (rejestracja aplikacji Entra ID).

Minimalne wymagane uprawnienia: rola dewelopera identyfikatora agenta

a365 setup blueprint [options]

blueprint Opcje

Option Description
-c, --config <config> Ścieżka pliku konfiguracji. Wartość domyślna to a365.config.json.
-v, --verbose Pokaż szczegółowe dane wyjściowe.
--dry-run Pokaż, co można zrobić bez wykonywania.
--no-endpoint Nie rejestruj punktu końcowego obsługi komunikatów (tylko strategia).
--endpoint-only Zarejestruj tylko punkt końcowy obsługi komunikatów. Wymaga istniejącej strategii.
-?, , -h--help Wyświetla informacje pomocy i użycia.

setup permissions

Skonfiguruj uprawnienia protokołu OAuth2 i uprawnienia do dziedziczenia.

Minimalne wymagane uprawnienia: Administrator globalny

a365 setup permissions [command] [options]

Opcje

Option Description
-?, , -h--help Wyświetla informacje pomocy i użycia.

Subcommands

Subcommand Description
mcp Skonfiguruj uprawnienia protokołu OAuth2 serwera MCP i można je dziedziczyć.
bot Skonfiguruj uprawnienia protokołu OAuth2 interfejsu API bota obsługi komunikatów i można je dziedziczyć.
custom Stosuje niestandardowe uprawnienia interfejsu API do strategii agenta, które wykraczają poza standardowe uprawnienia wymagane do operacji agenta.
copilotstudio Konfiguruje uprawnienia protokołu OAuth2 i uprawnienia dziedziczone dla strategii agenta w celu wywoływania Copilot Studio copilots za pośrednictwem interfejsu API platformy Power Platform.

setup permissions mcp

Skonfiguruj uprawnienia protokołu OAuth2 serwera MCP i można je dziedziczyć.

Minimalne wymagane uprawnienia: Administrator globalny

a365 setup permissions mcp [options]

To polecenie:

  • Odczytuje ToolingManifest.json z określonego deploymentProjectPath elementu w pliku a365.config.json.
  • Przyznaje uprawnienia delegowane OAuth2 dla każdego zakresu serwera MCP do strategii agenta.
  • Konfiguruje uprawnienia dziedziczone, aby wystąpienia agentów mogły uzyskiwać dostęp do narzędzi MCP.
  • Jest idempotentny i bezpieczny do wielokrotnego uruchamiania.

Ważne

  • Przed uruchomieniem tego polecenia uruchom polecenie a365 config display , aby sprawdzić, czy deploymentProjectPath wskazuje folder projektu zawierający zaktualizowany ToolingManifest.jsonelement . Jeśli deweloper dodaje serwery MCP na innej maszynie, najpierw udostępnij zaktualizowaną aktualizację ToolingManifest.json administratorowi globalnego. Uruchomienie bez poprawności ToolingManifest.json nie powoduje dodania nowych uprawnień serwera MCP do strategii.
  • Uruchom to polecenie po uruchomieniu a365 develop add-mcp-serversprzez dewelopera polecenia . Dodawanie serwerów MCP do manifestu i udzielanie uprawnień do strategii to dwa oddzielne kroki. Po zakończeniu tego polecenia uprawnienia serwera MCP są widoczne w strategii agenta.

permissions mcp Opcje

Option Description
-c, --config <config> Ścieżka pliku konfiguracji. Wartość domyślna to a365.config.json.
-v, --verbose Pokaż szczegółowe dane wyjściowe.
--dry-run Pokaż, co można zrobić bez wykonywania.
-?, , -h--help Wyświetla informacje pomocy i użycia.

setup permissions bot

Skonfiguruj uprawnienia protokołu OAuth2 interfejsu API bota obsługi komunikatów i można je dziedziczyć.

Minimalne wymagane uprawnienia: Administrator globalny

Wymagania wstępne: uprawnienia strategii i umowy MCP (uruchom a365 setup permissions mcp najpierw)

Dalej krok: Wdrażanie agenta (uruchom a365 deploy w przypadku hostowania w Azure)

a365 setup permissions bot [options]

permissions bot Opcje

Option Description
-c, --config <config> Ścieżka pliku konfiguracji. Wartość domyślna to a365.config.json.
-v, --verbose Pokaż szczegółowe dane wyjściowe.
--dry-run Pokaż, co można zrobić bez wykonywania.
-?, , -h--help Wyświetla informacje pomocy i użycia.

setup permissions custom

Stosuje niestandardowe uprawnienia interfejsu API do strategii agenta, które wykraczają poza standardowe uprawnienia wymagane do operacji agenta. Za pomocą tego polecenia udzielasz agentowi dostępu do dodatkowych zakresów Microsoft Graph, takich jak Obecność, Pliki i Czat, lub do niestandardowych interfejsów API zarejestrowanych w dzierżawie entra organizacji.

Minimalne wymagane uprawnienia: Administrator globalny

Wymagania wstępne: uruchom a365 setup blueprint najpierw. Dodaj uprawnienia niestandardowe do a365.config.json polecenia a365 config permissions przed uruchomieniem tego polecenia.

a365 setup permissions custom [options]

To polecenie:

  • Konfiguruje uprawnienia delegowane OAuth2 z zgodą administratora dla każdego skonfigurowanego zasobu.
  • Ustawia uprawnienia dziedziczone, aby użytkownicy agentów mogli dziedziczyć dostęp z strategii.
  • Uzgadnia Microsoft Entra z bieżącą konfiguracją przez dodanie nowych uprawnień i usunięcie wszelkich uprawnień usuniętych z konfiguracji.
  • Jest idempotentny i bezpieczny do wielokrotnego uruchamiania.

permissions custom Opcje

Option Description
-c, --config <config> Ścieżka pliku konfiguracji. Wartość domyślna to a365.config.json.
-v, --verbose Pokaż szczegółowe dane wyjściowe.
--dry-run Pokaż, co można zrobić bez wykonywania.
-?, , -h--help Wyświetla informacje pomocy i użycia.

Konfigurowanie uprawnień niestandardowych

Użyj a365 config permissions polecenia , aby dodać uprawnienia niestandardowe do konfiguracji przed uruchomieniem tego polecenia:

# Add Microsoft Graph extended permissions
a365 config permissions `
  --resource-app-id 00000003-0000-0000-c000-000000000000 `
  --scopes Presence.ReadWrite,Files.Read.All,Chat.Read

# Add custom API permissions
a365 config permissions `
  --resource-app-id <your-api-app-id> `
  --scopes CustomScope.Read,CustomScope.Write

# Apply all configured custom permissions
a365 setup permissions custom

Nazwa zasobu jest automatycznie rozpoznawana z Azure podczas instalacji. Nie musisz określać go w konfiguracji.

Usuwanie uprawnień niestandardowych

Aby usunąć uprawnienia niestandardowe z konfiguracji i Microsoft Entra:

# Step 1: Remove from config
a365 config permissions --reset

# Step 2: Reconcile Microsoft Entra with updated config
a365 setup permissions custom

Integracja z setup all

Po włączeniu uprawnień a365 setup all niestandardowych konfiguracja automatycznie je konfiguruje. Pełna kolejność konfiguracji to:

  1. Infrastruktura
  2. Schemat
  3. Uprawnienia mcp
  4. Uprawnienia interfejsu API bota
  5. Niestandardowe uprawnienia strategii (jeśli skonfigurowano)
  6. Punkt końcowy komunikacji

setup permissions copilotstudio

Konfiguruje uprawnienia protokołu OAuth2 i uprawnienia dziedziczone dla strategii agenta w celu wywoływania Copilot Studio copilots za pośrednictwem interfejsu API platformy Power Platform.

Minimalne wymagane uprawnienia: Administrator globalny

Wymagania wstępne: uruchom a365 setup blueprint najpierw.

a365 setup permissions copilotstudio [options]

To polecenie:

  • Gwarantuje, że jednostka usługi interfejsu API platformy Power Platform istnieje w dzierżawie.
  • Tworzy uprawnienie OAuth2 z strategii do interfejsu API platformy Power Platform z zakresem CopilotStudio.Copilots.Invoke .
  • Ustawia uprawnienia dziedziczone, aby wystąpienia agentów mogły wywoływać Copilot Studio copilots.

permissions copilotstudio Opcje

Option Description
-c, --config <config> Ścieżka pliku konfiguracji. Wartość domyślna to a365.config.json.
-v, --verbose Pokaż szczegółowe dane wyjściowe.
--dry-run Pokaż, co można zrobić bez wykonywania.
-?, , -h--help Wyświetla informacje pomocy i użycia.

Użyj tego polecenia, gdy agent musi wywołać Copilot Studio copilots w czasie wykonywania lub wywołać interfejsy API platformy Power Platform, które wymagają uprawnień programu CopilotStudio.

setup all

Wykonaj wszystkie kroki konfiguracji, aby skonfigurować środowisko agenta 365

a365 setup all [options]

Uruchamia pełną konfigurację agenta 365, wszystkie kroki w sekwencji.

Obejmuje: infrastruktura, strategia, uprawnienia i punkt końcowy.

Minimalne wymagane uprawnienia (administrator globalny ma wszystkie te uprawnienia):

  • współautor subskrypcji Azure (dla infrastruktury i punktu końcowego)
  • Rola dewelopera identyfikatora agenta (na potrzeby tworzenia strategii)
  • Administrator globalny (w przypadku udzielania uprawnień i zgody administratora)

setup all Opcje

Option Description
-c, --config <config> Ścieżka pliku konfiguracji. Wartość domyślna to a365.config.json.
-v, --verbose Pokaż szczegółowe dane wyjściowe.
--dry-run Pokaż, co można zrobić bez wykonywania.
--skip-infrastructure Pomiń tworzenie Azure infrastruktury (użyj, jeśli infrastruktura już istnieje). Ta opcja nadal tworzy: strategia, uprawnienia i punkt końcowy.
--skip-requirements Pomiń sprawdzanie poprawności wymagań. Użyj z ostrożnością: instalacja może zakończyć się niepowodzeniem, jeśli wymagania wstępne nie zostaną spełnione.
-?, , -h--help Wyświetla informacje pomocy i użycia.
  • Last updated on