az bot

Reference

Správa služby Microsoft Azure Bot Service

Příkazy

Name	Description	Typ	Stav
az bot authsetting	Správa nastavení připojení OAuth v robotovi	Základ	GA
az bot authsetting create	Vytvořte nastavení připojení OAuth v robotovi.	Základ	GA
az bot authsetting delete	Odstraňte nastavení připojení OAuth v robotovi.	Základ	GA
az bot authsetting list	Zobrazí všechna nastavení připojení OAuth v robotovi.	Základ	GA
az bot authsetting list-providers	Seznam podrobností pro všechny poskytovatele služeb, kteří jsou k dispozici pro vytváření nastavení připojení OAuth.	Základ	GA
az bot authsetting show	Zobrazení podrobností o nastavení připojení OAuth v robotovi	Základ	GA
az bot create	Vytvořte nového robota sady SDK v4.	Základ	GA
az bot delete	Odstraňte existujícího robota.	Základ	GA
az bot directline	Spravujte kanál Directline v robotovi.	Základ	Preview
az bot directline create	Vytvořte kanál DirectLine na robotovi s povoleným protokolem v3.	Základ	Preview
az bot directline delete	Odstraňte kanál Directline v robotovi.	Základ	Preview
az bot directline show	Získejte podrobnosti o kanálu Directline na robotovi.	Základ	Preview
az bot directline update	Aktualizujte kanál DirectLine na robotovi jenom s povoleným protokolem v3.	Základ	Preview
az bot download	Stáhněte si existujícího robota.	Základ	Preview
az bot email	Správa e-mailového kanálu v robotovi	Základ	Preview
az bot email create	Vytvořte e-mailový kanál na robotovi.	Základ	Preview
az bot email delete	Odstraňte e-mailový kanál na robotovi.	Základ	Preview
az bot email show	Získejte podrobnosti o e-mailovém kanálu robota.	Základ	Preview
az bot facebook	Spravujte facebookový kanál na robotovi.	Základ	Preview
az bot facebook create	Vytvořte facebookový kanál na robotovi.	Základ	Preview
az bot facebook delete	Odstraňte facebookový kanál na robotovi.	Základ	Preview
az bot facebook show	Získejte podrobnosti o facebookovém kanálu na robotovi.	Základ	Preview
az bot kik	Spravujte kanál Kik na robotovi.	Základ	Preview
az bot kik create	Vytvořte kanál Kik na robotovi.	Základ	Preview
az bot kik delete	Odstraňte kanál Kik na robotovi.	Základ	Preview
az bot kik show	Získejte podrobnosti o kanálu Kik na robotovi.	Základ	Preview
az bot msteams	Spravujte kanál Microsoft Teams v robotovi.	Základ	Preview
az bot msteams create	Vytvořte kanál Microsoft Teams na robotovi.	Základ	Preview
az bot msteams delete	Odstraňte kanál Microsoft Teams na robotovi.	Základ	Preview
az bot msteams show	Získejte podrobnosti o kanálu Microsoft Teams na robotovi.	Základ	Preview
az bot prepare-deploy	Přidání skriptů/konfiguračních souborů pro publikování pomocí `az webapp deployment`nástroje .	Základ	GA
az bot prepare-publish	(Režim údržby) Přidejte skripty do místního adresáře zdrojového kódu, abyste mohli publikovat zpět pomocí `az bot publish` robotů sady SDK v3.	Základ	Preview
az bot publish	Publikujte do služby App Service přidruženého k robotovi.	Základ	Preview
az bot show	Získejte existujícího robota.	Základ	GA
az bot skype	Spravujte kanál Skype na robotovi.	Základ	Preview
az bot skype create	Vytvořte kanál Skype na robotovi.	Základ	Preview
az bot skype delete	Odstraňte kanál Skype na robotovi.	Základ	Preview
az bot skype show	Získejte podrobnosti o kanálu Skype na robotovi.	Základ	Preview
az bot slack	Spravujte kanál Slack na robotovi.	Základ	Preview
az bot slack create	Vytvořte na robotovi kanál Slack.	Základ	Preview
az bot slack delete	Odstraňte kanál Slack na robotovi.	Základ	Preview
az bot slack show	Získejte podrobnosti o kanálu Slack na robotovi.	Základ	Preview
az bot sms	Spravujte kanál SMS na robotovi.	Základ	Preview
az bot sms create	Vytvořte kanál SMS na robotovi.	Základ	Preview
az bot sms delete	Odstraňte kanál SMS na robotovi.	Základ	Preview
az bot sms show	Získejte podrobnosti o kanálu SMS na robotovi.	Základ	Preview
az bot telegram	Spravujte kanál AplikaceGraf na robotovi.	Základ	Preview
az bot telegram create	Vytvoření kanáluKanálu AplikaceGraf na robotovi.	Základ	Preview
az bot telegram delete	Odstraňte kanál AplikaceGraf na robotovi.	Základ	Preview
az bot telegram show	Získejte podrobné informace o kanáluGraf na robotovi.	Základ	Preview
az bot update	Aktualizujte existujícího robota.	Základ	GA
az bot webchat	Spravujte kanál Webchatu na robotovi.	Základ	GA
az bot webchat show	Získejte podrobnosti o kanálu Webchat na robotovi.	Základ	GA

az bot create

Upravit

Vytvořte nového robota sady SDK v4.

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

Povinné parametry

--app-type

Typ aplikace Microsoftu pro robota Mezi možné hodnoty patří: UserAssignedMSI, SingleTenant, MultiTenant.

--appid

ID účtu Microsoft (MSA ID), které se má použít s robotem.

--name -n

Název prostředku robota. Název robota musí být dlouhý 4 až 42 znaků. Název robota může obsahovat pouze následující znaky: -, a–z, A–Z, 0–9 a _.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

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

Adresa URL klíče trezoru klíčů umožňující šifrování klíčů spravovaných zákazníkem.

--description -d

Popis robota.

--display-name

Zobrazovaný název robota. Pokud není zadaný, nastaví se výchozí název robota.

--endpoint -e

Koncový bod zasílání zpráv robota.

--location -l

Umístění. Hodnoty z: az account list-locations. Výchozí umístění můžete nakonfigurovat pomocí .az configure --defaults location=<location>

Default value: global

--msi-resource-id

ID prostředku spravované identity aplikace Microsoftu pro robota

--sku

Skladová položka robota.

Přípustné hodnoty: F0, S1

Default value: F0

--tags

Značky oddělené mezerami: klíč[=hodnota] [klíč[=hodnota] ...]. K vymazání existujících značek použijte "".

--tenant-id

ID tenanta aplikace Microsoftu pro robota

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az bot delete

Upravit

Odstraňte existujícího robota.

az bot delete --name
              --resource-group

Povinné parametry

--name -n

Název prostředku robota. Název robota musí být dlouhý 4 až 42 znaků. Název robota může obsahovat pouze následující znaky: -, a–z, A–Z, 0–9 a _.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az bot download

Upravit

Preview

Tento příkaz je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Stáhněte si existujícího robota.

Zdrojový kód se stáhne z webové aplikace přidružené k robotovi. Potom můžete provést změny a publikovat ho zpět do aplikace.

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

Povinné parametry

--name -n

Název prostředku robota. Název robota musí být dlouhý 4 až 42 znaků. Název robota může obsahovat pouze následující znaky: -, a–z, A–Z, 0–9 a _.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

--save-path

Adresář pro stažení kódu robota do.

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az bot prepare-deploy

Upravit

Přidání skriptů/konfiguračních souborů pro publikování pomocí az webapp deploymentnástroje .

Přidejte skripty nebo konfigurační soubory do kořenového adresáře místního zdrojového kódu, aby bylo možné publikovat pomocí az webapp deployment. Po nasazení kódu do vaší služby App Service by se vygenerované skripty nebo konfigurační soubory měly objevit na webové stránce D:\home\site\wwwroot na webové stránce Kudu služby App Service.

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

Příklady

Připravte se na nasazení javascriptového robota pomocí příkazu az webapp načtením souboru Node.js IIS web.config.

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

Připravte se na nasazení robota Csharp pomocí příkazu az webapp vytvořením souboru .deployment.

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

Povinné parametry

--lang

Jazyk nebo modul runtime robota.

Přípustné hodnoty: Csharp, Javascript, Typescript

Volitelné parametry

--code-dir

Adresář pro umístění vygenerovaných souborů nasazení. Ve výchozím nastavení se příkaz volá z aktuálního adresáře.

--proj-file-path

Cesta k souboru .csproj vzhledem k souboru --code-dir.

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az bot prepare-publish

Upravit

Preview

Tento příkaz je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

(Režim údržby) Přidejte skripty do místního adresáře zdrojového kódu, abyste mohli publikovat zpět pomocí az bot publish robotů sady SDK v3.

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

Povinné parametry

--name -n

Název prostředku robota. Název robota musí být dlouhý 4 až 42 znaků. Název robota může obsahovat pouze následující znaky: -, a–z, A–Z, 0–9 a _.

--proj-file-path

Cesta k názvu spouštěcího souboru projektu (Např. "./EchoBotWithCounter.csproj") Vyžaduje se pouze pro jazyk C#.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--sln-name

Název spouštěcího souboru řešení Vyžaduje se pouze pro jazyk C#.

Volitelné parametry

--code-dir

Adresář ke stažení skriptů nasazení do.

--version -v

Verze sady MICROSOFT Bot Builder SDK, která se použije v šabloně robota, která se vytvoří.

Přípustné hodnoty: v3, v4

Default value: v3

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az bot publish

Upravit

Preview

Tento příkaz je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Publikujte do služby App Service přidruženého k robotovi.

Publikujte zdrojový kód do služby App Service přidruženého k robotovi. Tato možnost je pro roboty v4 zastaralá a už se nedoporučuje publikovat roboty v4 do Azure. Místo toho použijte az bot prepare-deploy a az webapp deployment nasaďte robota v4. Další informace najdete tady: https://aka.ms/deploy-your-bot.

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

Příklady

Publikování zdrojového kódu do Aplikace Azure ze složky kódu robota

az bot publish -n botName -g MyResourceGroup

Povinné parametry

--name -n

Název prostředku robota. Název robota musí být dlouhý 4 až 42 znaků. Název robota může obsahovat pouze následující znaky: -, a–z, A–Z, 0–9 a _.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

--code-dir

Adresář pro nahrání kódu robota z.

--keep-node-modules

Ponechte node_modules složku a nespouští npm install se ve službě App Service. To může výrazně urychlit publikování příkazů pro roboty node.js SDK.

Přípustné hodnoty: false, true

--proj-file-path

Cesta k názvu spouštěcího souboru projektu (Např. "./EchoBotWithCounter.csproj").

--timeout -t

Konfigurovatelný časový limit v sekundách pro kontrolu stavu nasazení

--version -v

Verze sady Microsoft Bot Builder SDK robota.

Default value: v4

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az bot show

Upravit

Získejte existujícího robota.

Získejte informace o existujícím robotovi. K získání informací potřebných pro připojení k robotovi použijte příznak --msbot s příkazem.

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

Příklady

Získání informací potřebných pro připojení k existujícímu robotovi v Azure

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

Povinné parametry

--name -n

Název prostředku robota. Název robota musí být dlouhý 4 až 42 znaků. Název robota může obsahovat pouze následující znaky: -, a–z, A–Z, 0–9 a _.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

--msbot

Zobrazte výstup jako JSON kompatibilní se souborem .bot.

Přípustné hodnoty: false, true

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az bot update

Upravit

Aktualizujte existujícího robota.

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]

Příklady

Aktualizace popisu robota

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

Povinné parametry

--name -n

Název prostředku robota. Název robota musí být dlouhý 4 až 42 znaků. Název robota může obsahovat pouze následující znaky: -, a–z, A–Z, 0–9 a _.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

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

Aplikace Azure Přehledy klíč rozhraní API používaný ke čtení analytických dat robota. Pokud chcete zobrazit analýzu robota v okně Analýza, zadejte klíč.

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

Aplikace Azure Přehledy ID aplikace používané ke čtení dat analýzy robota. Pokud chcete zobrazit analýzu robota v okně Analýza, zadejte ID.

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

Aplikace Azure Přehledy Klíč použitý k zápisu analytických dat robota. Pokud chcete přijímat analýzy robota, zadejte klíč.

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

Adresa URL klíče trezoru klíčů umožňující šifrování klíčů spravovaných zákazníkem.

--cmk-off

Nastavte šifrování na klíče spravované Microsoftem.

--description

Nový popis robota.

--display-name -d

Nový zobrazovaný název robota.

--endpoint -e

Nový koncový bod robota. Musí začínat na "https://".

--icon-url

Adresa URL ikony pro avatar robota Přijímá soubory PNG s limitem velikosti souboru 30 kB.

--sku

Skladová položka robota.

Přípustné hodnoty: F0, S1

--tags

Značky oddělené mezerami: klíč[=hodnota] [klíč[=hodnota] ...]. K vymazání existujících značek použijte "".

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Sdílet prostřednictvím

az bot

Příkazy

az bot create

Povinné parametry

Volitelné parametry

az bot delete

Povinné parametry

az bot download

Povinné parametry

Volitelné parametry

az bot prepare-deploy

Příklady

Povinné parametry

Volitelné parametry

az bot prepare-publish

Povinné parametry

Volitelné parametry

az bot publish

Příklady

Povinné parametry

Volitelné parametry

az bot show

Příklady

Povinné parametry

Volitelné parametry

az bot update

Příklady

Povinné parametry

Volitelné parametry

Další materiály