Udostępnij za pośrednictwem

Dokumentacja poleceń interfejsu wiersza polecenia config 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.

Zarządzanie konfiguracją interfejsu wiersza polecenia agenta 365. Udostępnia opcje zarządzania ustawieniami konfiguracji interfejsu wiersza polecenia agenta 365. Nowe konfiguracje można zainicjować interaktywnie lub wyświetlić bieżące ustawienia konfiguracji.

Wymagana minimalna rola: Brak (konfiguracja lokalna)

Składnia

a365 config [command] [options]

Opcje

Option Description
-?, , -h--help Pokaż informacje o pomocy i użyciu.

config init

Interaktywnie skonfiguruj interfejs wiersza polecenia agenta 365 lub zaimportuj go z pliku.

a365 config init [options]

Użyj tego polecenia, aby skonfigurować konfigurację interfejsu wiersza polecenia agenta 365 za pośrednictwem procesu interaktywnego lub przez zaimportowanie ustawień z istniejącego pliku konfiguracji.

init Opcje

Option Description
-c, --configfile <configfile> Ścieżka do istniejącego pliku konfiguracji do zaimportowania
-g, --global Utwórz konfigurację w katalogu globalnym (AppData) zamiast bieżącego katalogu
-?, , -h--help Pokaż informacje o pomocy i użyciu.

Uwagi

Polecenie config init uruchamia interaktywnego kreatora, który minimalizuje ręczne wprowadzanie danych wejściowych:

  • Azure CLI integracja: Automatycznie wykrywa subskrypcję, dzierżawę, grupy zasobów, plany usługi App Service i regiony.
  • Inteligentne wartości domyślne: generuje nazwy zasobów z nazwy agenta i znacznik czasu (na przykład myagent-webapp-11140916). Te nazwy można dostosować przed zapisaniem.
  • Wykrycie platformy: Wykrywa typ projektu (.NET, Node.js, Python) ze ścieżki projektu wdrożenia i ostrzega, jeśli nie znaleziono obsługiwanego typu.
  • Walidacja aplikacji klienckiej: weryfikuje identyfikator aplikacji klienckiej względem dzierżawy firmy Entra, sprawdzając, czy wymagane uprawnienia są skonfigurowane, a zgoda administratora została udzielona. Przed zakończeniem pracy kreatora trzeba wykonać maksymalnie trzy próby.

Dostosowanie strategii niestandardowej (opcjonalnie): Kreator zawiera opcjonalny krok konfigurowania uprawnień dla dodatkowych zasobów zewnętrznych, takich jak obecność usługi Teams lub pliki OneDrive. Większość agentów tego nie wymaga. Uprawnienia można również skonfigurować po początkowej konfiguracji przy użyciu polecenia a365 config permissions.

Aktualizowanie istniejącej konfiguracji: ponowne uruchomienie a365 config init powoduje załadowanie bieżącej wartości a365.config.json jako domyślnej. Naciśnij klawisz Enter w każdym wierszu, aby zachować bieżącą wartość, lub wpisz nową wartość, aby ją zaktualizować.

config display

Pokaż bieżącą konfigurację interfejsu wiersza polecenia agenta 365.

a365 config display [options]

To polecenie wyświetla bieżące ustawienia konfiguracji dla interfejsu wiersza polecenia agenta 365, aby można było przejrzeć bieżącą konfigurację.

display Opcje

Option Description
-g, --generated Wyświetl wygenerowaną konfigurację (a365.generated.config.json).
-a, --all Wyświetl zarówno konfigurację statyczną, jak i wygenerowaną.
-f, --field <field> Wyprowadź dane wyjściowe wartości pojedynczego pola (na przykład: --field messagingEndpoint).
-?, , -h--help Pokaż informacje o pomocy i użyciu.

Uwagi

Użyj --field polecenia , aby pobrać pojedynczą wartość z konfiguracji do użycia w skryptach lub innych poleceniach. Jeśli używasz tej opcji z opcją -g lub -a, interfejs wiersza polecenia najpierw przeszukuje wygenerowaną konfigurację.

# Get the messaging endpoint from generated config
a365 config display -g --field messagingEndpoint

# Get a value from static config
a365 config display --field webAppName

Struktura pliku konfiguracji

Interfejs wiersza polecenia używa pliku konfiguracji JSON (a365.config.json) z następującymi właściwościami klucza:

{
  "$schema": "./a365.config.schema.json",
  "tenantId": "your-tenant-id",
  "subscriptionId": "your-subscription-id",
  "resourceGroup": "rg-Agent 365-example",
  "location": "westus",
  "appServicePlanName": "asp-Agent 365-example",
  "appServicePlanSku": "B1",
  "webAppName": "webapp-Agent 365-example",
  "agentBlueprintDisplayName": "My Agent 365 Blueprint",
  "agentIdentityDisplayName": "My Agent 365 Agent",
  "agentUserPrincipalName": "agent@contoso.onmicrosoft.com",
  "agentUserDisplayName": "My Agent 365 User",
  "managerEmail": "manager@contoso.onmicrosoft.com",
  "agentUserUsageLocation": "US",
  "agentIdentityScopes": [
    "User.Read",
    "Mail.Send",
    "Calendars.ReadWrite",
    "Files.ReadWrite"
  ],
  "agentApplicationScopes": [
    "Mail.ReadWrite",
    "Chat.ReadWrite",
    "Sites.Read.All"
  ],
  "deploymentProjectPath": ".",
  "deploymentProjectFile": "YourProject.csproj",
  "botName": "my-Agent 365-bot",
  "botDescription": "My AI-powered agent for Microsoft 365 tasks"
}
  • Last updated on