Speech service-tárolók konfigurálása
A beszédtárolók lehetővé teszik az ügyfelek számára, hogy egy olyan beszédalkalmazás-architektúrát építsenek ki, amely a robusztus felhőbeli képességek és a peremhálózat kihasználása érdekében van optimalizálva.
A Speech-tároló futtatókörnyezete a docker run parancsargumentumok használatával van konfigurálva. Ez a tároló rendelkezik néhány szükséges és választható beállításokkal. A tárolóspecifikus beállítások a számlázási beállítások.
Konfigurációs beállítások
A tároló konfigurációs beállításai a következők:
| Szükséges | Beállítás | Cél |
|---|---|---|
| Igen | ApiKey | Nyomon követi a számlázási adatokat. |
| Nem | ApplicationInsights | Lehetővé teszi Azure-alkalmazás Elemzések telemetriai támogatás hozzáadását a tárolóhoz. |
| Igen | Számlázás | Az Azure-beli szolgáltatáserőforrás végponti URI-ját adja meg. |
| Igen | Eula | Azt jelzi, hogy elfogadta a tároló licencét. |
| Nem | Fluentd | Napló- és metrikaadatokat ír egy Fluentd-kiszolgálóra. |
| Nem | HTTP-proxy | HTTP-proxyt konfigurál kimenő kérések végrehajtásához. |
| Nem | Logging | ASP.NET Alapvető naplózási támogatást biztosít a tárolóhoz. |
| Nem | Tartók | Adatokat olvas be és ír a gazdaszámítógépről a tárolóba, majd a tárolóból vissza a gazdaszámítógépre. |
Fontos
A ApiKeyrendszer együtt használja a , Billingés Eula a beállításokat, és mind a háromhoz érvényes értékeket kell megadnia; ellenkező esetben a tároló nem indul el. A tárolók példányosításához a konfigurációs beállítások használatával kapcsolatos további információkért lásd a Számlázás című témakört.
ApiKey konfigurációs beállítás
A ApiKey beállítás megadja a tároló számlázási adatainak nyomon követéséhez használt Azure-erőforráskulcsot. Meg kell adnia egy értéket az ApiKey számára, és az értéknek érvényes kulcsnak kell lennie a konfigurációs beállításhoz megadott Speech-erőforráshozBilling.
Ez a beállítás a következő helyen található:
- Azure Portal: Speech Resource Management, kulcsok alatt
Alkalmazás Elemzések beállítás
A ApplicationInsights beállítással Azure-alkalmazás Elemzések telemetriai támogatást adhat a tárolóhoz. Az alkalmazás Elemzések a tároló részletes monitorozását biztosítja. A tárolót egyszerűen monitorozhatja a rendelkezésre állás, a teljesítmény és a használat szempontjából. Emellett gyorsan azonosíthatja és diagnosztizálhatja a tároló hibáit.
Az alábbi táblázat a szakaszban támogatott ApplicationInsights konfigurációs beállításokat ismerteti.
| Szükséges | Név | Adattípus | Leírás |
|---|---|---|---|
| Nem | InstrumentationKey |
Sztring | Az alkalmazás eszközkulcsa Elemzések példány, amelyre a tároló telemetriai adatait küldi. További információ: Application Elemzések for ASP.NET Core. Példa: InstrumentationKey=123456789 |
Számlázási konfigurációs beállítás
A Billing beállítás megadja az Azure Speech-erőforrás végponti URI-ját, amelyet a tároló számlázási adatainak mérésére használnak. Meg kell adnia egy értéket ehhez a konfigurációs beállításhoz, és az értéknek érvényes végponti URI-nak kell lennie egy Azure-beli Speech-erőforráshoz . A tároló körülbelül 10–15 percenként jelenti a használatot.
Ez a beállítás a következő helyen található:
- Azure Portal: Felirat a
EndpointSpeech áttekintési oldalán
| Szükséges | Név | Adattípus | Leírás |
|---|---|---|---|
| Igen | Billing |
Sztring | Számlázási végpont URI-ja. A számlázási URI beszerzéséről további információt a számlázásban talál. További információkért és a regionális végpontok teljes listájáért tekintse meg az Azure AI-szolgáltatások egyéni altartományneveit. |
Eula beállítás
A Eula beállítás azt jelzi, hogy elfogadta a tároló licencét. Ehhez a konfigurációs beállításhoz meg kell adnia egy értéket, az értéknek pedig a következőre acceptkell lennie.
| Szükséges | Név | Adattípus | Leírás |
|---|---|---|---|
| Igen | Eula |
Sztring | Licenc elfogadása Példa: Eula=accept |
Az Azure AI-szolgáltatások tárolóinak licencelése az Ön szerződése alapján, az Azure használatára vonatkozik. Ha nem rendelkezik az Azure használatára vonatkozó meglévő szerződéssel, elfogadja, hogy az Azure használatára vonatkozó szerződése a Microsoft Online Előfizetési Szerződés, amely tartalmazza az online szolgáltatási feltételeket. Az előzetes verziók esetében ön elfogadja a Microsoft Azure Előzetes verzióra vonatkozó kiegészítő használati feltételeket is. A tároló használatával elfogadja ezeket a feltételeket.
Fluentd-beállítások
A Fluentd egy nyílt forráskódú adatgyűjtő az egységes naplózáshoz. A Fluentd beállítások kezelik a tároló fluentd-kiszolgálóhoz való kapcsolatát. A tároló tartalmaz egy Fluentd naplózási szolgáltatót, amely lehetővé teszi, hogy a tároló naplókat írjon, és opcionálisan metrikaadatokat írjon egy Fluentd-kiszolgálóra.
Az alábbi táblázat a szakaszban támogatott Fluentd konfigurációs beállításokat ismerteti.
| Név | Adattípus | Leírás |
|---|---|---|
Host |
Sztring | A Fluentd-kiszolgáló IP-címe vagy DNS-állomásneve. |
Port |
Egész | A Fluentd-kiszolgáló portja. Az alapértelmezett érték 24224. |
HeartbeatMs |
Egész | A szívverési időköz ezredmásodpercben. Ha az időköz lejárta előtt nem küldött eseményforgalmat, a rendszer szívverést küld a Fluentd-kiszolgálónak. Az alapértelmezett érték 60000 ezredmásodperc (1 perc). |
SendBufferSize |
Egész | A küldési műveletekhez lefoglalt hálózati pufferterület bájtban. Az alapértelmezett érték 32768 bájt (32 kilobájt). |
TlsConnectionEstablishmentTimeoutMs |
Egész | Ezredmásodpercben az időtúllépés a Fluentd-kiszolgálóval létesített SSL-/TLS-kapcsolat létrehozásához. Az alapértelmezett érték 10000 ezredmásodperc (10 másodperc). Ha UseTLS hamis értékre van állítva, a rendszer figyelmen kívül hagyja ezt az értéket. |
UseTLS |
Logikai | Azt jelzi, hogy a tárolónak SSL/TLS protokollt kell-e használnia a Fluentd-kiszolgálóval való kommunikációhoz. Az alapértelmezett érték: hamis. |
HTTP-proxy hitelesítő adatainak beállításai
Ha HTTP-proxyt kell konfigurálnia a kimenő kérések végrehajtásához, használja az alábbi két argumentumot:
| Név | Adattípus | Leírás |
|---|---|---|
| HTTP_PROXY | húr | A használni kívánt proxy, például: http://proxy:8888<proxy-url> |
| HTTP_PROXY_CREDS | húr | A proxyn való hitelesítéshez szükséges hitelesítő adatok, például username:password. Ennek az értéknek kisbetűsnek kell lennie. |
<proxy-user> |
húr | A proxy felhasználója. |
<proxy-password> |
húr | A proxyhoz <proxy-user> társított jelszó. |
docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
--mount type=bind,src=/home/azureuser/output,target=/output \
<registry-location>/<image-name> \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
HTTP_PROXY=<proxy-url> \
HTTP_PROXY_CREDS=<proxy-user>:<proxy-password> \
Naplózási beállítások
A Logging beállítások kezelik a tároló ASP.NET Core naplózási támogatását. Ugyanazokat a konfigurációs beállításokat és értékeket használhatja a tárolóhoz, amelyeket egy ASP.NET Core-alkalmazáshoz használ.
A tároló a következő naplózási szolgáltatókat támogatja:
| Szolgáltató | Cél |
|---|---|
| Console | A ASP.NET Core Console naplózási szolgáltató. A naplózási szolgáltató összes ASP.NET alapkonfigurációs beállítása és alapértelmezett értéke támogatott. |
| Debug | A ASP.NET Core Debug naplózási szolgáltató. A naplózási szolgáltató összes ASP.NET alapkonfigurációs beállítása és alapértelmezett értéke támogatott. |
| Disk | A JSON-naplózási szolgáltató. Ez a naplózási szolgáltató naplóadatokat ír a kimeneti csatlakoztatáshoz. |
Ez a tárolóparancs JSON formátumban tárolja a naplózási adatokat a kimeneti csatlakoztatáshoz:
docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
--mount type=bind,src=/home/azureuser/output,target=/output \
<registry-location>/<image-name> \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
Logging:Disk:Format=json \
Mounts:Output=/output
Ez a tárolóparancs a hibakeresési információkat jeleníti meg, a tároló futása közben előtaggal dbug:
docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
<registry-location>/<image-name> \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
Logging:Console:LogLevel:Default=Debug
Lemeznaplózás
A Disk naplózási szolgáltató a következő konfigurációs beállításokat támogatja:
| Név | Adattípus | Leírás |
|---|---|---|
Format |
Sztring | A naplófájlok kimeneti formátuma. Megjegyzés: Ezt az értéket úgy kell beállítani, hogy json engedélyezze a naplózási szolgáltatót. Ha ez az érték anélkül van megadva, hogy kimeneti csatlakoztatást is megad a tároló példányosítása közben, hiba történik. |
MaxFileSize |
Egész | A naplófájl maximális mérete megabájtban (MB). Ha az aktuális naplófájl mérete eléri vagy meghaladja ezt az értéket, a naplózási szolgáltató elindít egy új naplófájlt. Ha -1 van megadva, a naplófájl méretét csak a kimeneti csatlakoztatás maximális fájlmérete korlátozza. Az alapértelmezett érték 1. |
A ASP.NET Core naplózási támogatásának konfigurálásáról további információt Gépház fájlkonfigurációban talál.
Csatlakoztatási beállítások
A kötés csatlakoztatásával adatokat olvashat és írhat a tárolóba és onnan. A docker-futtatási --mount parancs beállításának megadásával bemeneti csatlakoztatást vagy kimeneti csatlakoztatást is megadhat.
A Standard Speech-tárolók nem használnak bemeneti vagy kimeneti csatlakoztatásokat a betanítási vagy szolgáltatási adatok tárolásához. Az egyéni beszédtárolók azonban kötetcsatlakozásokon alapulnak.
A gazdagép csatlakoztatási helyének pontos szintaxisa a gazdagép operációs rendszerétől függően változik. Emellett előfordulhat, hogy a gazdaszámítógép csatlakoztatási helye nem érhető el a Docker szolgáltatásfiók által használt engedélyek és a gazdagép csatlakoztatási helyének engedélyei közötti ütközés miatt.
Kötet csatlakoztatási beállításai
Az egyéni beszédtárolók kötetcsatlakoztatásokkal megőrzik az egyéni modelleket. A kötet csatlakoztatását úgy adhatja meg, hogy hozzáadja a -v (vagy --volume) beállítást a Docker-futtatási parancshoz.
Feljegyzés
A kötet csatlakoztatási beállításai csak a szövegtárolókhoz való egyéni beszédhez alkalmazhatók.
Az egyéni modellek az első alkalommal töltődnek le, amikor az egyéni beszédtároló docker run parancs részeként betöltenek egy új modellt. Az egyéni beszédtárolókhoz azonos ModelId szekvenciális futtatások a korábban letöltött modellt használják. Ha a kötet csatlakoztatása nincs megadva, az egyéni modellek nem tárolhatók.
A kötet csatlakoztatási beállítása három színnel : elválasztott mezőből áll:
- Az első mező a gazdagép kötetének neve, például C:\input.
- A második mező a tároló könyvtára, például /usr/local/models.
- A harmadik mező (nem kötelező) a lehetőségek vesszővel tagolt listája. További információ: használati kötetek.
Íme egy kötetcsatlakoztatási példa, amely a C:\bemeneti gazdagép könyvtárát csatlakoztatja a tárolók /usr/local/models könyvtárhoz.
-v C:\input:/usr/local/models