az bot

Odwołanie

Zarządzanie Bot Service platformy Microsoft Azure.

Polecenia

az bot authsetting	Zarządzanie ustawieniami połączenia OAuth w bocie.
az bot authsetting create	Utwórz ustawienie połączenia OAuth dla bota.
az bot authsetting delete	Usuń ustawienie połączenia OAuth w bocie.
az bot authsetting list	Pokaż wszystkie ustawienia połączenia OAuth w bocie.
az bot authsetting list-providers	Wyświetl szczegóły wszystkich dostawców usług dostępnych do tworzenia ustawień połączenia OAuth.
az bot authsetting show	Pokaż szczegóły ustawienia połączenia OAuth w bocie.
az bot create	Utwórz nowego bota zestawu SDK w wersji 4.
az bot delete	Usuń istniejącego bota.
az bot directline	Zarządzanie kanałem Directline w bocie.
az bot directline create	Utwórz kanał DirectLine w bocie z włączonym tylko protokołem w wersji 3.
az bot directline delete	Usuń kanał Directline w bocie.
az bot directline show	Uzyskaj szczegółowe informacje o kanale Directline w bocie.
az bot directline update	Zaktualizuj kanał DirectLine w bocie tylko z włączonym protokołem w wersji 3.
az bot download	Pobierz istniejącego bota.
az bot email	Zarządzanie kanałem e-mail w botze.
az bot email create	Utwórz kanał poczty e-mail w botze.
az bot email delete	Usuń kanał e-mail w botze.
az bot email show	Uzyskaj szczegółowe informacje o kanale poczty e-mail w botze.
az bot facebook	Zarządzanie kanałem Serwisu Facebook w bocie.
az bot facebook create	Utwórz kanał facebookowy w bocie.
az bot facebook delete	Usuń kanał facebookowy w bocie.
az bot facebook show	Uzyskaj szczegółowe informacje na temat kanału Facebook na bota.
az bot kik	Zarządzanie kanałem Kik w bocie.
az bot kik create	Utwórz kanał Kik w bocie.
az bot kik delete	Usuń kanał Kik w bocie.
az bot kik show	Uzyskaj szczegółowe informacje o kanale Kik w bocie.
az bot msteams	Zarządzanie kanałem Microsoft Teams w botze.
az bot msteams create	Utwórz kanał Microsoft Teams w botze.
az bot msteams delete	Usuń kanał Microsoft Teams w botze.
az bot msteams show	Uzyskaj szczegółowe informacje o kanale Microsoft Teams w botze.
az bot prepare-deploy	Dodaj skrypty/pliki konfiguracji do publikowania za pomocą polecenia `az webapp deployment`.
az bot prepare-publish	(Tryb konserwacji) Dodaj skrypty do lokalnego katalogu kodu źródłowego, aby móc publikować z powrotem przy użyciu `az bot publish` botów zestawu SDK w wersji 3.
az bot publish	Publikowanie w skojarzonej usłudze app Service bota.
az bot show	Pobierz istniejącego bota.
az bot skype	Zarządzanie kanałem Skype w botze.
az bot skype create	Utwórz kanał Skype w botze.
az bot skype delete	Usuń kanał Skype w botze.
az bot skype show	Uzyskaj szczegółowe informacje o kanale Skype w botze.
az bot slack	Zarządzanie kanałem Slack w botze.
az bot slack create	Utwórz kanał Slack na bota.
az bot slack delete	Usuń kanał Slack na bota.
az bot slack show	Uzyskaj szczegółowe informacje o kanale Slack w botze.
az bot sms	Zarządzanie kanałem SMS w botze.
az bot sms create	Utwórz kanał SMS w botze.
az bot sms delete	Usuń kanał SMS w botze.
az bot sms show	Uzyskaj szczegółowe informacje o kanale SMS w botze.
az bot telegram	Zarządzanie kanałem Telegram w bocie.
az bot telegram create	Utwórz kanał Telegram na bota.
az bot telegram delete	Usuń kanał Telegram na bota.
az bot telegram show	Uzyskaj szczegółowe informacje na temat kanału Telegram na bota.
az bot update	Zaktualizuj istniejącego bota.
az bot webchat	Zarządzanie kanałem Webchat w botze.
az bot webchat show	Uzyskaj szczegółowe informacje o kanale Webchat w botze.

az bot create

Edytuj

Utwórz nowego bota zestawu SDK w wersji 4.

az bot create --app-type
              --appid
              --name
              --resource-group
              [--cmk]
              [--description]
              [--display-name]
              [--endpoint]
              [--location]
              [--msi-resource-id]
              [--sku {F0, S1}]
              [--tags]
              [--tenant-id]

Parametry wymagane

--app-type

Typ aplikacji firmy Microsoft dla bota.

--appid

Identyfikator konta Microsoft (IDENTYFIKATOR MSA) do użycia z botem.

--name -n

Nazwa zasobu bota. Nazwa bota musi mieć długość od 4 do 42 znaków. Nazwa bota może zawierać tylko następujące znaki: -, a–z, A–Z, 0–9 i _.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry opcjonalne

--cmk --cmk-key-vault-key-url

Adres URL klucza magazynu kluczy umożliwiający włączenie szyfrowania kluczy zarządzanych przez klienta.

--description -d

Opis bota.

--display-name

Nazwa wyświetlana bota. Jeśli nie zostanie określony, wartość domyślna to nazwa bota.

--endpoint -e

Punkt końcowy obsługi komunikatów bota.

--location -l

Lokalizacja. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

wartość domyślna: global

--msi-resource-id

Identyfikator zasobu tożsamości zarządzanej aplikacji firmy Microsoft dla bota.

--sku

Jednostka SKU bota.

akceptowane wartości: F0, S1

wartość domyślna: F0

--tags

Tagi rozdzielone spacjami: klucz[=wartość] [klucz[=wartość] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.

--tenant-id

Identyfikator dzierżawy aplikacji firmy Microsoft dla bota.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykłady.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debug, aby uzyskać pełne dzienniki debugowania.

az bot delete

Edytuj

Usuń istniejącego bota.

az bot delete --name
              --resource-group

Parametry wymagane

--name -n

Nazwa zasobu bota. Nazwa bota musi mieć długość od 4 do 42 znaków. Nazwa bota może zawierać tylko następujące znaki: -, a–z, A–Z, 0–9 i _.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykłady.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debug, aby uzyskać pełne dzienniki debugowania.

az bot download

Edytuj

Pobierz istniejącego bota.

Kod źródłowy jest pobierany z aplikacji internetowej skojarzonej z botem. Następnie możesz wprowadzić zmiany i opublikować je z powrotem w aplikacji.

az bot download --name
                --resource-group
                [--save-path]

Parametry wymagane

--name -n

Nazwa zasobu bota. Nazwa bota musi mieć długość od 4 do 42 znaków. Nazwa bota może zawierać tylko następujące znaki: -, a–z, A–Z, 0–9 i _.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry opcjonalne

--save-path

Katalog do pobrania kodu bota.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykłady.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debug, aby uzyskać pełne dzienniki debugowania.

az bot prepare-deploy

Edytuj

Dodaj skrypty/pliki konfiguracji do publikowania za pomocą polecenia az webapp deployment.

Dodaj skrypty lub pliki konfiguracji do katalogu głównego lokalnego katalogu kodu źródłowego, aby móc publikować przy użyciu polecenia az webapp deployment. Po wdrożeniu kodu w App Service wygenerowane skrypty lub pliki konfiguracji powinny być wyświetlane w katalogu D:homesitewwwroot na stronie internetowej Kudu App Service.

az bot prepare-deploy --lang {Csharp, Javascript, Typescript}
                      [--code-dir]
                      [--proj-file-path]

Przykłady

Przygotowanie do wdrożenia `az webapp` bota javascript przez pobranie pliku web.config iis Node.js.

az bot prepare-deploy --lang Javascript --code-dir "MyBotCode"

Przygotuj się do użycia `az webapp` do wdrożenia bota Csharp, tworząc plik wdrożenia.

az bot prepare-deploy --lang Csharp --code-dir "." --proj-file-path "MyBot.csproj"

Parametry wymagane

--lang

Język lub środowisko uruchomieniowe bota.

akceptowane wartości: Csharp, Javascript, Typescript

Parametry opcjonalne

--code-dir

Katalog umożliwiający umieszczenie wygenerowanych plików wdrożenia. Domyślnie dla bieżącego katalogu polecenie jest wywoływane z.

--proj-file-path

Ścieżka do pliku csproj względem --code-dir.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykłady.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debug, aby uzyskać pełne dzienniki debugowania.

az bot prepare-publish

Edytuj

(Tryb konserwacji) Dodaj skrypty do lokalnego katalogu kodu źródłowego, aby móc publikować z powrotem przy użyciu az bot publish botów zestawu SDK w wersji 3.

az bot prepare-publish --name
                       --proj-file-path
                       --resource-group
                       --sln-name
                       [--code-dir]
                       [--version {v3, v4}]

Parametry wymagane

--name -n

Nazwa zasobu bota. Nazwa bota musi mieć długość od 4 do 42 znaków. Nazwa bota może zawierać tylko następujące znaki: -, a–z, A–Z, 0–9 i _.

--proj-file-path

Ścieżka do nazwy pliku projektu uruchamiania. (np. Plik "./EchoBotWithCounter.csproj") Wymagany tylko dla języka C#.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--sln-name

Nazwa pliku rozwiązania uruchamiania. Wymagane tylko dla języka C#.

Parametry opcjonalne

--code-dir

Katalog służący do pobierania skryptów wdrażania.

--version -v

Wersja zestawu MICROSOFT Bot Builder SDK do użycia w szablonie bota, który zostanie utworzony.

akceptowane wartości: v3, v4

wartość domyślna: v3

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykłady.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debug, aby uzyskać pełne dzienniki debugowania.

az bot publish

Edytuj

Publikowanie w skojarzonej usłudze app Service bota.

Opublikuj kod źródłowy w skojarzonej usłudze aplikacji bota. Jest to PRZESTARZAŁE dla botów w wersji 4 i nie jest już zalecane do publikowania botów w wersji 4 na platformie Azure. Zamiast tego należy użyć polecenia az bot prepare-deploy i az webapp deployment wdrożyć bota w wersji 4. Aby uzyskać więcej informacji, zobacz https://aka.ms/deploy-your-bot.

az bot publish --name
               --resource-group
               [--code-dir]
               [--keep-node-modules {false, true}]
               [--proj-file-path]
               [--timeout]
               [--version]

Przykłady

Publikowanie kodu źródłowego w aplikacja systemu Azure z poziomu folderu kodu bota

az bot publish -n botName -g MyResourceGroup

Parametry wymagane

--name -n

Nazwa zasobu bota. Nazwa bota musi mieć długość od 4 do 42 znaków. Nazwa bota może zawierać tylko następujące znaki: -, a–z, A–Z, 0–9 i _.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry opcjonalne

--code-dir

Katalog do przekazywania kodu bota z.

--keep-node-modules

Zachowaj folder node_modules i nie uruchamiaj npm install go w App Service. Może to znacznie przyspieszyć publikowanie poleceń dla botów zestawu SDK Node.js.

akceptowane wartości: false, true

--proj-file-path

Ścieżka do nazwy pliku projektu uruchamiania. (np. "./EchoBotWithCounter.csproj").

--timeout -t

Konfigurowalny limit czasu w sekundach w celu sprawdzenia stanu wdrożenia.

--version -v

Wersja zestawu MICROSOFT Bot Builder SDK bota.

wartość domyślna: v4

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykłady.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debug, aby uzyskać pełne dzienniki debugowania.

az bot show

Edytuj

Pobierz istniejącego bota.

Uzyskaj informacje o istniejącym botze. Aby uzyskać informacje potrzebne do nawiązania połączenia z botem, użyj flagi --msbot z poleceniem .

az bot show --name
            --resource-group
            [--msbot {false, true}]

Przykłady

Pobieranie informacji potrzebnych do nawiązania połączenia z istniejącym botem na platformie Azure

az bot show -n botName -g MyResourceGroup --msbot

Parametry wymagane

--name -n

Nazwa zasobu bota. Nazwa bota musi mieć długość od 4 do 42 znaków. Nazwa bota może zawierać tylko następujące znaki: -, a–z, A–Z, 0–9 i _.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry opcjonalne

--msbot

Pokaż dane wyjściowe jako zgodne z plikiem JSON z plikiem bota.

akceptowane wartości: false, true

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykłady.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debug, aby uzyskać pełne dzienniki debugowania.

az bot update

Edytuj

Zaktualizuj istniejącego bota.

az bot update --name
              --resource-group
              [--ai-api-key]
              [--ai-app-id]
              [--ai-key]
              [--cmk]
              [--cmk-off]
              [--description]
              [--display-name]
              [--endpoint]
              [--icon-url]
              [--sku {F0, S1}]
              [--tags]

Przykłady

Aktualizowanie opisu bota

az bot update -n botName -g MyResourceGroup --endpoint "https://bing.com/api/messages" --display-name "Hello World"

Parametry wymagane

--name -n

Nazwa zasobu bota. Nazwa bota musi mieć długość od 4 do 42 znaków. Nazwa bota może zawierać tylko następujące znaki: -, a–z, A–Z, 0–9 i _.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry opcjonalne

--ai-api-key --app-insights-api-key

aplikacja systemu Azure Klucz interfejsu API szczegółowych informacji używany do odczytywania danych analizy botów. Podaj klucz, jeśli chcesz wyświetlić analizę bota w bloku Analiza.

--ai-app-id --app-insights-app-id

aplikacja systemu Azure Insights Identyfikator aplikacji używany do odczytywania danych analizy botów. Podaj identyfikator, jeśli chcesz wyświetlić analizę bota w bloku Analiza.

--ai-key --app-insights-key

aplikacja systemu Azure Klucz szczegółowych informacji używany do pisania danych analizy botów. Podaj klucz, jeśli chcesz otrzymywać analizę botów.

--cmk --cmk-key-vault-key-url

Adres URL klucza magazynu kluczy umożliwiający włączenie szyfrowania kluczy zarządzanych przez klienta.

--cmk-off

Ustaw szyfrowanie na Microsoft-Managed Keys.

--description

Nowy opis bota.

--display-name -d

Nowa nazwa wyświetlana bota.

--endpoint -e

Nowy punkt końcowy bota. Musi zaczynać się od ciągu "https://".

--icon-url

Adres URL ikony awatara bota. Akceptuje pliki PNG z limitem rozmiaru pliku 30 KB.

--sku

Jednostka SKU bota.

akceptowane wartości: F0, S1

--tags

Tagi rozdzielone spacjami: klucz[=wartość] [klucz[=wartość] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykłady.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debug, aby uzyskać pełne dzienniki debugowania.