az bot

  • Referencia

A Microsoft Azure Bot Service kezelése.

Parancsok

Name Description Típus Állapot
az bot authsetting

OAuth-kapcsolati beállítások kezelése egy roboton.

 Alapvető FE
az bot authsetting create

OAuth-kapcsolatbeállítás létrehozása egy roboton.

 Alapvető FE
az bot authsetting delete

OAuth-kapcsolatbeállítás törlése egy roboton.

 Alapvető FE
az bot authsetting list

Az OAuth-kapcsolat összes beállításának megjelenítése egy roboton.

 Alapvető FE
az bot authsetting list-providers

Az OAuth-kapcsolat beállításainak létrehozásához elérhető összes szolgáltató adatainak listája.

 Alapvető FE
az bot authsetting show

OAuth-kapcsolati beállítás részleteinek megjelenítése egy roboton.

 Alapvető FE
az bot create

Hozzon létre egy új v4 SDK-robotot.

 Alapvető FE
az bot delete

Meglévő robot törlése.

 Alapvető FE
az bot directline

A Directline-csatorna kezelése egy roboton.

 Alapvető Előnézet megtekintése
az bot directline create

Hozza létre a DirectLine-csatornát egy olyan roboton, amelyen csak a v3 protokoll engedélyezve van.

 Alapvető Előnézet megtekintése
az bot directline delete

Törölje a Directline-csatornát egy roboton.

 Alapvető Előnézet megtekintése
az bot directline show

A Directline-csatorna részleteinek lekérése egy roboton.

 Alapvető Előnézet megtekintése
az bot directline update

Frissítse a DirectLine-csatornát egy olyan roboton, amely csak a v3 protokollt engedélyezi.

 Alapvető Előnézet megtekintése
az bot download

Töltsön le egy meglévő robotot.

 Alapvető Előnézet megtekintése
az bot email

Az e-mail csatorna kezelése egy roboton.

 Alapvető Előnézet megtekintése
az bot email create

Hozza létre az e-mail csatornát egy roboton.

 Alapvető Előnézet megtekintése
az bot email delete

Törölje az e-mail-csatornát egy roboton.

 Alapvető Előnézet megtekintése
az bot email show

Az e-mail csatorna részleteinek lekérése egy roboton.

 Alapvető Előnézet megtekintése
az bot facebook

A Facebook-csatorna kezelése egy roboton.

 Alapvető Előnézet megtekintése
az bot facebook create

Hozza létre a Facebook-csatornát egy roboton.

 Alapvető Előnézet megtekintése
az bot facebook delete

Törölje a Facebook-csatornát egy roboton.

 Alapvető Előnézet megtekintése
az bot facebook show

A Facebook-csatorna részleteinek lekérése egy roboton.

 Alapvető Előnézet megtekintése
az bot kik

A Kik-csatorna kezelése egy roboton.

 Alapvető Előnézet megtekintése
az bot kik create

Hozza létre a Kik-csatornát egy roboton.

 Alapvető Előnézet megtekintése
az bot kik delete

Törölje a Kik-csatornát egy roboton.

 Alapvető Előnézet megtekintése
az bot kik show

A Kik-csatorna részleteinek lekérése egy roboton.

 Alapvető Előnézet megtekintése
az bot msteams

A Microsoft Teams Channel kezelése roboton.

 Alapvető Előnézet megtekintése
az bot msteams create

Hozza létre a Microsoft Teams-csatornát egy roboton.

 Alapvető Előnézet megtekintése
az bot msteams delete

Törölje a Microsoft Teams-csatornát egy roboton.

 Alapvető Előnézet megtekintése
az bot msteams show

A Microsoft Teams Channel részleteinek lekérése egy roboton.

 Alapvető Előnézet megtekintése
az bot prepare-deploy

Szkriptek/konfigurációs fájlok hozzáadása közzétételhez a következővel az webapp deployment: .

 Alapvető FE
az bot prepare-publish

(Karbantartási mód) Adjon hozzá szkripteket a helyi forráskódkönyvtárhoz, hogy a v3 SDK-robotok használatával az bot publish újra közzétehesse a fájlt.

 Alapvető Előnézet megtekintése
az bot publish

Közzététel a robot társított appszolgáltatásában.

 Alapvető Előnézet megtekintése
az bot show

Meglévő robot lekérése.

 Alapvető FE
az bot skype

A Skype-csatorna kezelése roboton.

 Alapvető Előnézet megtekintése
az bot skype create

Hozza létre a Skype-csatornát egy roboton.

 Alapvető Előnézet megtekintése
az bot skype delete

Törölje a Skype-csatornát egy roboton.

 Alapvető Előnézet megtekintése
az bot skype show

A Skype-csatorna részleteinek lekérése egy roboton.

 Alapvető Előnézet megtekintése
az bot slack

A Slack Channel kezelése egy roboton.

 Alapvető Előnézet megtekintése
az bot slack create

Hozza létre a Slack-csatornát egy roboton.

 Alapvető Előnézet megtekintése
az bot slack delete

Törölje a Slack-csatornát egy roboton.

 Alapvető Előnézet megtekintése
az bot slack show

A Slack Channel részleteinek lekérése egy roboton.

 Alapvető Előnézet megtekintése
az bot sms

Az SMS-csatorna kezelése roboton.

 Alapvető Előnézet megtekintése
az bot sms create

Hozza létre az SMS-csatornát egy roboton.

 Alapvető Előnézet megtekintése
az bot sms delete

Törölje az SMS-csatornát egy roboton.

 Alapvető Előnézet megtekintése
az bot sms show

Az SMS-csatorna részleteinek lekérése egy roboton.

 Alapvető Előnézet megtekintése
az bot telegram

A Telegram-csatorna kezelése roboton.

 Alapvető Előnézet megtekintése
az bot telegram create

Hozza létre a Telegram-csatornát egy roboton.

 Alapvető Előnézet megtekintése
az bot telegram delete

Törölje a Telegram-csatornát egy roboton.

 Alapvető Előnézet megtekintése
az bot telegram show

A Telegram-csatorna részleteinek lekérése egy roboton.

 Alapvető Előnézet megtekintése
az bot update

Meglévő robot frissítése.

 Alapvető FE
az bot webchat

A Webchat Channel kezelése egy roboton.

 Alapvető FE
az bot webchat show

A webchat-csatorna részleteinek lekérése egy roboton.

 Alapvető FE

az bot create

Szerkesztés

Hozzon létre egy új v4 SDK-robotot.

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

Kötelező paraméterek

--app-type

Microsoft-alkalmazástípus a robothoz. A lehetséges értékek a következők: "UserAssignedMSI", "SingleTenant", "MultiTenant".

--appid

A robothoz használandó Microsoft-fiókazonosító (MSA-azonosító).

--name -n

A robot erőforrásneve. A robot neve csak 4 és 42 karakter közötti hosszúságú lehet. A robot nevében csak a következő karakterek szerepelhetnek: -, a–z, A–Z, 0–9 és _.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

Opcionális paraméterek

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

A kulcstartó kulcsának URL-címe az ügyfél által felügyelt kulcsok titkosításának engedélyezéséhez.

--description -d

A robot leírása.

--display-name

A robot megjelenítendő neve. Ha nincs megadva, alapértelmezés szerint a robot neve lesz.

--endpoint -e

A robot üzenetkezelési végpontja.

--location -l

Tartózkodási hely beállításnál. Értékek: az account list-locations. Az alapértelmezett helyet a következővel az configure --defaults location=<location>konfigurálhatja: .

alapértelmezett érték: global
--msi-resource-id

Microsoft App Managed Identity Resource Id a robothoz.

--sku

A robot termékváltozata.

elfogadott értékek: F0, S1
alapértelmezett érték: F0
--tags

Szóközzel elválasztott címkék: key[=value] [key[=value] ...]. Meglévő címkék törlése a "" használatával.

--tenant-id

A robot Microsoft App Tenant Id azonosítója.

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az bot delete

Szerkesztés

Meglévő robot törlése.

az bot delete --name
              --resource-group

Kötelező paraméterek

--name -n

A robot erőforrásneve. A robot neve csak 4 és 42 karakter közötti hosszúságú lehet. A robot nevében csak a következő karakterek szerepelhetnek: -, a–z, A–Z, 0–9 és _.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az bot download

Szerkesztés
Előnézet

Ez a parancs előzetes verzióban és fejlesztés alatt áll. Referencia- és támogatási szintek: https://aka.ms/CLI_refstatus

Töltsön le egy meglévő robotot.

A forráskódot a robothoz társított webalkalmazásból tölti le a rendszer. Ezután módosíthatja azt, és közzéteheti az alkalmazásban.

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

Kötelező paraméterek

--name -n

A robot erőforrásneve. A robot neve csak 4 és 42 karakter közötti hosszúságú lehet. A robot nevében csak a következő karakterek szerepelhetnek: -, a–z, A–Z, 0–9 és _.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

Opcionális paraméterek

--save-path

A robotkód letöltéséhez használandó könyvtár.

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az bot prepare-deploy

Szerkesztés

Szkriptek/konfigurációs fájlok hozzáadása közzétételhez a következővel az webapp deployment: .

Szkriptek vagy konfigurációs fájlok hozzáadása a helyi forráskódkönyvtár gyökeréhez a közzétételhez az webapp deployment. Amikor a kódot üzembe helyezi az App Service-ben, a létrehozott szkripteknek vagy konfigurációs fájloknak meg kell jelennie az App Service Kudu webhelyén található D:\home\site\wwwroot fájlban.

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

Példák

Készüljön fel egy Javascript-robot üzembe helyezésére az "az webapp" használatával egy Node.js IIS web.config fájl beolvasásával.

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

Készüljön fel arra, hogy az "az webapp" használatával üzembe helyez egy Csharp-robotot egy .deployment fájl létrehozásával.

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

Kötelező paraméterek

--lang

A robot nyelve vagy futtatókörnyezete.

elfogadott értékek: Csharp, Javascript, Typescript

Opcionális paraméterek

--code-dir

A létrehozott üzembehelyezési fájlok elhelyezéséhez szükséges könyvtár. A parancsot meghívó aktuális könyvtár alapértelmezett értéke.

--proj-file-path

A .csproj fájl elérési útja a --code-dir fájlhoz viszonyítva.

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az bot prepare-publish

Szerkesztés
Előnézet

Ez a parancs előzetes verzióban és fejlesztés alatt áll. Referencia- és támogatási szintek: https://aka.ms/CLI_refstatus

(Karbantartási mód) Adjon hozzá szkripteket a helyi forráskódkönyvtárhoz, hogy a v3 SDK-robotok használatával az bot publish újra közzétehesse a fájlt.

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

Kötelező paraméterek

--name -n

A robot erőforrásneve. A robot neve csak 4 és 42 karakter közötti hosszúságú lehet. A robot nevében csak a következő karakterek szerepelhetnek: -, a–z, A–Z, 0–9 és _.

--proj-file-path

Az indítási projektfájl nevének elérési útja. (Pl. "./EchoBotWithCounter.csproj") Csak A C#-hoz szükséges.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

--sln-name

Az indítási megoldás fájljának neve. Csak A C#-hoz szükséges.

Opcionális paraméterek

--code-dir

A telepítési szkriptek letöltéséhez szükséges könyvtár.

--version -v

A létrehozandó robotsablonban használandó Microsoft Bot Builder SDK-verzió.

elfogadott értékek: v3, v4
alapértelmezett érték: v3
Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az bot publish

Szerkesztés
Előnézet

Ez a parancs előzetes verzióban és fejlesztés alatt áll. Referencia- és támogatási szintek: https://aka.ms/CLI_refstatus

Közzététel a robot társított appszolgáltatásában.

Tegye közzé a forráskódot a robot társított appszolgáltatásában. Ez elavult a v4-robotok esetében, és már nem ajánlott a v4-robotok Azure-ban való közzétételéhez. Ehelyett használja az bot prepare-deploy és az webapp deployment telepítse a v4-robotot. További információ eléréséhez lásd: 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éldák

Forráskód közzététele a Azure-alkalmazás a robotkód mappájából

az bot publish -n botName -g MyResourceGroup

Kötelező paraméterek

--name -n

A robot erőforrásneve. A robot neve csak 4 és 42 karakter közötti hosszúságú lehet. A robot nevében csak a következő karakterek szerepelhetnek: -, a–z, A–Z, 0–9 és _.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

Opcionális paraméterek

--code-dir

A robotkód feltöltéséhez használandó könyvtár.

--keep-node-modules

Tartsa meg node_modules mappát, és ne futtassa npm install az App Service-ben. Ez jelentősen felgyorsíthatja a Node.js SDK-robotok közzétételi parancsait.

elfogadott értékek: false, true
--proj-file-path

Az indítási projektfájl nevének elérési útja. (Pl. "./EchoBotWithCounter.csproj").

--timeout -t

Konfigurálható időtúllépés másodpercben az üzembe helyezés állapotának ellenőrzéséhez.

--version -v

A robot Microsoft Bot Builder SDK-verziója.

alapértelmezett érték: v4
Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az bot show

Szerkesztés

Meglévő robot lekérése.

Információk lekérése egy meglévő robotról. A robothoz való csatlakozáshoz szükséges információk lekéréséhez használja az --msbot jelzőt a paranccsal.

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

Példák

Az Azure-beli meglévő robothoz való csatlakozáshoz szükséges információk lekérése

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

Kötelező paraméterek

--name -n

A robot erőforrásneve. A robot neve csak 4 és 42 karakter közötti hosszúságú lehet. A robot nevében csak a következő karakterek szerepelhetnek: -, a–z, A–Z, 0–9 és _.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

Opcionális paraméterek

--msbot

A kimenet megjelenítése JSON-kompatibilisként egy .bot fájllal.

elfogadott értékek: false, true
Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az bot update

Szerkesztés

Meglévő robot frissítése.

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éldák

Frissítés leírása egy roboton

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

Kötelező paraméterek

--name -n

A robot erőforrásneve. A robot neve csak 4 és 42 karakter közötti hosszúságú lehet. A robot nevében csak a következő karakterek szerepelhetnek: -, a–z, A–Z, 0–9 és _.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

Opcionális paraméterek

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

Azure-alkalmazás Elemzések robotelemzési adatok olvasásához használt API-kulcsot. Adjon meg egy kulcsot, ha meg szeretné tekinteni a robot elemzéseit az Elemzés panelen.

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

Azure-alkalmazás Elemzések robotelemzési adatok olvasásához használt alkalmazásazonosító. Adjon meg egy azonosítót, ha meg szeretné tekinteni a robot elemzéseit az Elemzés panelen.

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

Azure-alkalmazás Elemzések robotelemzési adatok írásához használt kulcs. Adjon meg egy kulcsot, ha robotelemzést szeretne kapni.

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

A kulcstartó kulcsának URL-címe az ügyfél által felügyelt kulcsok titkosításának engedélyezéséhez.

--cmk-off

Állítsa be a titkosítást a Microsoft által felügyelt kulcsok értékre.

--description

A robot új leírása.

--display-name -d

A robot új megjelenítendő neve.

--endpoint -e

A robot új végpontja. A "https://" betűvel kell kezdődnie.

--icon-url

A robot avatarjának ikon URL-címe. A 30 KB-os fájlméretkorláttal rendelkező PNG-fájlokat fogadja el.

--sku

A robot termékváltozata.

elfogadott értékek: F0, S1
--tags

Szóközzel elválasztott címkék: key[=value] [key[=value] ...]. Meglévő címkék törlése a "" használatával.

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.