Egyéni beszédmodell üzembe helyezése

Cikk
04/15/2024

Ebből a cikkből megtudhatja, hogyan helyezhet üzembe végpontokat egyéni beszédmodellekhez. A kötegelt átírás kivételével egyéni végpontot kell üzembe helyeznie egy egyéni beszédmodell használatához.

Tipp.

A Batch átírási API-val való egyéni beszéd használatához nincs szükség üzemeltetett üzembehelyezési végpontra. Ha az egyéni beszédmodellt csak kötegelt átíráshoz használják, az erőforrásokat meg lehet takarékoskodni. További információkért lásd a Speech service díjszabását.

Üzembe helyezhet egy végpontot egy alap- vagy egyéni modellhez, majd később frissítheti a végpontot, hogy jobban betanított modellt használjon.

Feljegyzés

A Speech-erőforrások által F0 használt végpontok hét nap után törlődnek.

Üzembehelyezési végpont hozzáadása

Egyéni végpont létrehozásához kövesse az alábbi lépéseket:

Jelentkezzen be a Speech Studióba.
Válassza az Egyéni beszéd> a projekt neve >Modellek üzembe helyezése lehetőséget.

Ha ez az első végpontja, láthatja, hogy a táblában nincsenek felsorolva végpontok. Ha létrehoz egy végpontot, ezen az oldalon követheti az üzembe helyezett végpontokat.
Válassza a Modell üzembe helyezése lehetőséget az új végpont varázsló elindításához.
Az Új végpont lapon adja meg az egyéni végpont nevét és leírását.
Válassza ki az egyéni modellt, amelyet a végpontjához kíván társítani.
A jelölőnégyzet bejelölésével engedélyezheti a végpont forgalmának hang- és diagnosztikai naplózását .
Válassza a Hozzáadás lehetőséget a végpont mentéséhez és üzembe helyezéséhez.

A Modellek központi telepítése lapon az új végpont részletei jelennek meg egy táblázatban, például név, leírás, állapot és lejárati dátum. Az egyéni modelleket használó új végpont példányosítása akár 30 percet is igénybe vehet. Amikor az üzembe helyezés állapota sikeresre változik, a végpont készen áll a használatra.

Fontos

Jegyezze fel a modell lejárati dátumát. Ez az utolsó dátum, amikor az egyéni modellt használhatja a beszédfelismeréshez. További információ: Modell és végpont életciklusa.

Válassza ki a végponthivatkozást a rá vonatkozó információk, például a végpontkulcs, a végpont URL-címe és a mintakód megtekintéséhez.

Végpont létrehozásához és modell üzembe helyezéséhez használja a spx csr endpoint create parancsot. A kérelemparamétereket az alábbi utasítások szerint hozhatja létre:

Állítsa a project paramétert egy meglévő projekt azonosítójára. Ez azért ajánlott, hogy a végpontot a Speech Studióban is megtekinthesse és felügyelhesse. Futtathatja a parancsot az spx csr project list elérhető projektek lekéréséhez.
Állítsa a szükséges model paramétert a végponton üzembe helyezni kívánt modell azonosítójára.
Adja meg a szükséges language paramétert. A végpont területi beállításának meg kell egyeznie a modell területi beállításával. A területi beállítás később nem módosítható. A Speech CLI language paraméter megfelel a locale JSON-kérés és -válasz tulajdonságának.
Adja meg a szükséges name paramétert. Ez az a név, amely a Speech Studióban jelenik meg. A Speech CLI name paraméter megfelel a displayName JSON-kérés és -válasz tulajdonságának.
Igény szerint beállíthatja a paramétert logging . Ezt úgy állíthatja be, hogy enabled engedélyezze a végpont forgalmának hang- és diagnosztikai naplózását . Az alapértelmezett érték false.

Íme egy példa Speech CLI-parancs egy végpont létrehozásához és egy modell üzembe helyezéséhez:

spx csr endpoint create --api-version v3.1 --project YourProjectId --model YourModelId --name "My Endpoint" --description "My Endpoint Description" --language "en-US"

A válasz törzsének a következő formátumban kell érkeznie:

{
  "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/98375aaa-40c2-42c4-b65c-f76734fc7790",
  "model": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/base/ae8d1643-53e4-4554-be4c-221dcfb471c5"
  },
  "links": {
    "logs": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/98375aaa-40c2-42c4-b65c-f76734fc7790/files/logs",
    "restInteractive": "https://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "restConversation": "https://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "restDictation": "https://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "webSocketInteractive": "wss://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "webSocketConversation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "webSocketDictation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790"
  },
  "project": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/projects/d40f2eb8-1abf-4f72-9008-a5ae8add82a4"
  },
  "properties": {
    "loggingEnabled": true
  },
  "lastActionDateTime": "2022-05-19T15:27:51Z",
  "status": "NotStarted",
  "createdDateTime": "2022-05-19T15:27:51Z",
  "locale": "en-US",
  "displayName": "My Endpoint",
  "description": "My Endpoint Description"
}

A válasz törzsének legfelső szintű self tulajdonsága a végpont URI-ja. Ezzel az URI-val részletes információkat kaphat a végpont projektjéről, modelljéről és naplóiról. Ezzel az URI-val is frissítheti a végpontot.

A Speech CLI végpontokkal kapcsolatos súgójához futtassa a következő parancsot:

spx help csr endpoint

Végpont létrehozásához és modell üzembe helyezéséhez használja a Speech to text REST API Endpoints_Create műveletét. A kérelem törzsének összeállítása az alábbi utasítások szerint:

Állítsa a project tulajdonságot egy meglévő projekt URI-jára. Ez azért ajánlott, hogy a végpontot a Speech Studióban is megtekinthesse és felügyelhesse. Projects_List kérést is kérhet az elérhető projektek beszerzéséhez.
Állítsa be a szükséges model tulajdonságot a végponton üzembe helyezni kívánt modell URI-jára.
Állítsa be a szükséges locale tulajdonságot. A végpont területi beállításának meg kell egyeznie a modell területi beállításával. A területi beállítás később nem módosítható.
Állítsa be a szükséges displayName tulajdonságot. Ez az a név, amely a Speech Studióban jelenik meg.
Igény szerint beállíthatja a tulajdonságot a következőn belülproperties: .loggingEnabled> Ezt úgy állíthatja be, hogy true engedélyezze a végpont forgalmának hang- és diagnosztikai naplózását . Az alapértelmezett érték false.

Hozzon létre egy HTTP POST-kérést az URI használatával az alábbi Endpoints_Create példában látható módon. Cserélje le YourSubscriptionKey a Speech erőforráskulcsát, cserélje le YourServiceRegion a Speech erőforrásterületre, és állítsa be a kérés törzstulajdonságait a korábban leírtak szerint.

curl -v -X POST -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey" -H "Content-Type: application/json" -d '{
  "project": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/projects/d40f2eb8-1abf-4f72-9008-a5ae8add82a4"
  },
  "properties": {
    "loggingEnabled": true
  },
  "displayName": "My Endpoint",
  "description": "My Endpoint Description",
  "model": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/base/ae8d1643-53e4-4554-be4c-221dcfb471c5"
  },
  "locale": "en-US",
}'  "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints"

A válasz törzsének a következő formátumban kell érkeznie:

{
  "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/98375aaa-40c2-42c4-b65c-f76734fc7790",
  "model": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/base/ae8d1643-53e4-4554-be4c-221dcfb471c5"
  },
  "links": {
    "logs": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/98375aaa-40c2-42c4-b65c-f76734fc7790/files/logs",
    "restInteractive": "https://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "restConversation": "https://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "restDictation": "https://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "webSocketInteractive": "wss://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "webSocketConversation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "webSocketDictation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790"
  },
  "project": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/projects/d40f2eb8-1abf-4f72-9008-a5ae8add82a4"
  },
  "properties": {
    "loggingEnabled": true
  },
  "lastActionDateTime": "2022-05-19T15:27:51Z",
  "status": "NotStarted",
  "createdDateTime": "2022-05-19T15:27:51Z",
  "locale": "en-US",
  "displayName": "My Endpoint",
  "description": "My Endpoint Description"
}

Modell módosítása és végpont ismételt üzembe helyezése

A végpontok frissíthetők egy másik modell használatára, amelyet ugyanaz a Speech-erőforrás hozott létre. Ahogy korábban említettük, a modell lejárata előtt frissítenie kell a végpont modelljét.

Új modell használata és az egyéni végpont ismételt üzembe helyezése:

Jelentkezzen be a Speech Studióba.
Válassza az Egyéni beszéd> a projekt neve >Modellek üzembe helyezése lehetőséget.
Válassza ki a végpontra mutató hivatkozást név szerint, majd válassza a Modell módosítása lehetőséget.
Válassza ki azt az új modellt, amelyet a végpont használni szeretne.
Válassza a Kész lehetőséget a végpont mentéséhez és ismételt üzembe helyezéséhez.

Az egyéni végpont új modellel való ismételt üzembe helyezéséhez használja a spx csr model update parancsot. A kérelemparamétereket az alábbi utasítások szerint hozhatja létre:

Állítsa be a szükséges endpoint paramétert az üzembe helyezni kívánt végpont azonosítójára.
Állítsa a szükséges model paramétert a végponton üzembe helyezni kívánt modell azonosítójára.

Íme egy példa Speech CLI-parancsra, amely újra üzembe helyezi az egyéni végpontot egy új modellel:

spx csr endpoint update --api-version v3.1 --endpoint YourEndpointId --model YourModelId

A válasz törzsének a következő formátumban kell érkeznie:

{
  "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/98375aaa-40c2-42c4-b65c-f76734fc7790",
  "model": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/1e47c19d-12ca-4ba5-b177-9e04bd72cf98"
  },
  "links": {
    "logs": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/98375aaa-40c2-42c4-b65c-f76734fc7790/files/logs",
    "restInteractive": "https://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "restConversation": "https://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "restDictation": "https://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "webSocketInteractive": "wss://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "webSocketConversation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "webSocketDictation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790"
  },
  "project": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/projects/639d5280-8995-40cc-9329-051fd0fddd46"
  },
  "properties": {
    "loggingEnabled": true
  },
  "lastActionDateTime": "2022-05-19T23:01:34Z",
  "status": "NotStarted",
  "createdDateTime": "2022-05-19T15:41:27Z",
  "locale": "en-US",
  "displayName": "My Endpoint",
  "description": "My Updated Endpoint Description"
}

A Speech CLI végpontokkal kapcsolatos súgójához futtassa a következő parancsot:

spx help csr endpoint

Az egyéni végpont új modellel való ismételt üzembe helyezéséhez használja a Speech to text REST API Endpoints_Update műveletét. A kérelem törzsének összeállítása az alábbi utasítások szerint:

Állítsa a tulajdonságot model a végponton üzembe helyezni kívánt modell URI-jára.

Hozzon létre egy HTTP PATCH-kérést az URI használatával az alábbi példában látható módon. Cserélje le YourSubscriptionKey a Speech erőforráskulcsot, cserélje le YourServiceRegion a Speech erőforrásrégiójára, cserélje le YourEndpointId a végpontazonosítóra, és állítsa be a kérés törzstulajdonságait a korábban leírtak szerint.

curl -v -X PATCH -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey" -H "Content-Type: application/json" -d '{
  "model": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/1e47c19d-12ca-4ba5-b177-9e04bd72cf98"
  }
}'  "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/YourEndpointId"

A válasz törzsének a következő formátumban kell érkeznie:

{
  "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/98375aaa-40c2-42c4-b65c-f76734fc7790",
  "model": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/1e47c19d-12ca-4ba5-b177-9e04bd72cf98"
  },
  "links": {
    "logs": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/98375aaa-40c2-42c4-b65c-f76734fc7790/files/logs",
    "restInteractive": "https://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "restConversation": "https://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "restDictation": "https://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "webSocketInteractive": "wss://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "webSocketConversation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "webSocketDictation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790"
  },
  "project": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/projects/639d5280-8995-40cc-9329-051fd0fddd46"
  },
  "properties": {
    "loggingEnabled": true
  },
  "lastActionDateTime": "2022-05-19T23:01:34Z",
  "status": "NotStarted",
  "createdDateTime": "2022-05-19T15:41:27Z",
  "locale": "en-US",
  "displayName": "My Endpoint",
  "description": "My Updated Endpoint Description"
}

Az újbóli üzembe helyezés több percet vesz igénybe. Addig is a végpont a szolgáltatás megszakítása nélkül használja az előző modellt.

Naplózási adatok megtekintése

Ha a végpont létrehozásakor konfigurálta, a naplózási adatok exportálhatók.

A végpontnaplók letöltése:

Jelentkezzen be a Speech Studióba.
Válassza az Egyéni beszéd> a projekt neve >Modellek üzembe helyezése lehetőséget.
Válassza ki a hivatkozást végpontnév alapján.
A Tartalomnaplózás területen válassza a Letöltési napló lehetőséget.

A végpont naplóinak lekéréséhez használja a spx csr endpoint list parancsot. A kérelemparamétereket az alábbi utasítások szerint hozhatja létre:

Állítsa be a szükséges endpoint paramétert a naplók lekéréséhez használni kívánt végpont azonosítójára.

Íme egy példa a Speech CLI-parancsra, amely naplókat kér le egy végponthoz:

spx csr endpoint list --api-version v3.1 --endpoint YourEndpointId

A további részleteket tartalmazó naplófájlok helyei a válasz törzsében jelennek meg.

Egy végpont naplóinak lekéréséhez először használja a Speech to text REST API Endpoints_Get műveletét.

Http GET-kérés létrehozása az URI használatával az alábbi példában látható módon. Cserélje le YourEndpointId a végpontazonosítót, cserélje le YourSubscriptionKey a Speech erőforráskulcsra, és cserélje le YourServiceRegion a Speech erőforrásrégiójára.

curl -v -X GET "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/YourEndpointId" -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey"

A válasz törzsének a következő formátumban kell érkeznie:

{
  "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/98375aaa-40c2-42c4-b65c-f76734fc7790",
  "model": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/1e47c19d-12ca-4ba5-b177-9e04bd72cf98"
  },
  "links": {
    "logs": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/98375aaa-40c2-42c4-b65c-f76734fc7790/files/logs",
    "restInteractive": "https://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "restConversation": "https://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "restDictation": "https://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "webSocketInteractive": "wss://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "webSocketConversation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790",
    "webSocketDictation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=98375aaa-40c2-42c4-b65c-f76734fc7790"
  },
  "project": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/projects/2f78cdb7-58ac-4bd9-9bc6-170e31483b26"
  },
  "properties": {
    "loggingEnabled": true
  },
  "lastActionDateTime": "2022-05-19T23:41:05Z",
  "status": "Succeeded",
  "createdDateTime": "2022-05-19T23:41:05Z",
  "locale": "en-US",
  "displayName": "My Endpoint",
  "description": "My Updated Endpoint Description"
}

HTTP GET kérést kezdeményezhet az előző választörzs "naplói" URI-jának használatával. Cserélje le YourEndpointId a végpontazonosítót, cserélje le YourSubscriptionKey a Speech erőforráskulcsra, és cserélje le YourServiceRegion a Speech erőforrásrégiójára.

curl -v -X GET "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/YourEndpointId/files/logs" -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey"

A további részleteket tartalmazó naplófájlok helyei a válasz törzsében jelennek meg.

A naplózási adatok 30 napig érhetők el a Microsoft tulajdonában lévő tárolóban, majd törlődnek. Ha a saját tárfiókja az Azure AI-szolgáltatások előfizetéséhez van csatolva, a naplózási adatok nem törlődnek automatikusan.

Egyéni beszédmodell üzembe helyezése

Üzembehelyezési végpont hozzáadása

Modell módosítása és végpont ismételt üzembe helyezése

Naplózási adatok megtekintése

Következő lépések

További források