مشاركة عبر

نشر نموذج كلام مخصص

  • مقالة

في هذه المقالة، ستتعلم كيفية نشر نقطة نهاية لنموذج كلام مخصص. باستثناء النسخ الدفعي، يجب نشر نقطة نهاية مخصصة لاستخدام نموذج كلام مخصص.

تلميح

لا يلزم وجود نقطة نهاية نشر مستضافة لاستخدام الكلام المخصص مع واجهة برمجة تطبيقات النسخ الدفعي. يمكنك الحفاظ على الموارد إذا تم استخدام نموذج الكلام المخصص فقط للنسخ الدفعي. لمزيد من المعلومات، راجع أسعار خدمة Speech.

يمكنك توزيع نقطة نهاية لنموذج أساسي أو مخصص، ثم تحديث نقطة النهاية لاحقاً لاستخدام نموذج أفضل تدريباً.

إشعار

نقاط النهاية المستخدمة بواسطة F0 يتم حذف موارد الكلام بعد سبعة أيام.

أضف نقطة نهاية للتوزيع

لإنشاء نقطة نهاية مخصصة، اتبع الخطوات التالية:

  1. سجّل الدخول إلـى Speech Studio.

  2. حدد الكلام> المخصص اسم >المشروع نشر النماذج.

    إذا كانت هذه هي نقطة النهاية الأولى، فستلاحظ عدم وجود نقاط نهاية مدرجة في الجدول. بعد إنشاء نقطة نهاية، يمكنك استخدام هذه الصفحة لتعقب كل نقطة نهاية تم توزيعها.

  3. حدد Deploy model لبدء معالج نقطة النهاية الجديد.

  4. في صفحة New endpoin، أدخل اسماً ووصفاً لنقطة النهاية المخصصة.

  5. حدد النموذج المخصص الذي تريد إقرانه بنقطة النهاية.

  6. اختيارياً، يمكنك تحديد المربع لتمكين logging الصوت والتشخيص لحركة مرور نقطة النهاية.

    لقطة شاشة لصفحة نقطة نهاية جديدة تعرض مربع الاختيار لتمكين التسجيل.

  7. حدد Add لحفظ وتوزيع نقطة النهاية.

في الصفحة الرئيسية Deploy models، يتم عرض تفاصيل بشأن نقطة النهاية الجديدة في جدول، مثل الاسم والوصف والحالة وتاريخ انتهاء الصلاحية. قد يستغرق الأمر ما يصل إلى 30 دقيقة لإنشاء مثيل لنقطة نهاية جديدة تستخدم نماذجك المخصصة. عندما تتغير حالة التوزيع إلى Succeeded، تكون نقطة النهاية جاهزة للاستخدام.

هام

لاحظ تاريخ انتهاء صلاحية النموذج. هذا هو آخر تاريخ يمكنك فيه استخدام النموذج المخصص للتعرف على الكلام. لمزيد من المعلومات، راجع دورة حياة النموذج ونقطة النهاية.

حدد ارتباط نقطة النهاية لعرض المعلومات الخاصة به، مثل مفتاح نقطة النهاية وعنوان URL لنقطة النهاية ونموذج التعليمة البرمجية.

لإنشاء نقطة نهاية وتوزيع نموذج، استخدم الأمر spx csr endpoint create. أنشئ عمليات الطلب وفقاً للتعليمات التالية:

  • تعيين المعلمة project إلى معرف المشروع الموجود. يوصى بذلك حتى يمكنك أيضاً عرض نقطة النهاية وإدارتها في Speech Studio. يمكنك تشغيل الأمر spx csr project list للحصول على المشاريع المتوفرة.
  • قم بتعيين معلمة model المطلوبة لمعرف النموذج الذي تريد توزيعه إلى نقطة النهاية.
  • يوصى بتعيين المعلمة language المطلوبة. يجب أن تتطابق لغة نقطة النهاية مع الإعدادات المحلية للنموذج. لا يمكن تغيير الإعدادات المحلية لاحقًا. المعلمة Speech CLIlanguageمتوافقة مع الخاصيةlocaleفي طلب JSON والاستجابة.
  • يوصى بتعيين المعلمة name المطلوبة. هذا هو الاسم الذي يتم عرضه في Speech Studio. المعلمة Speech CLInameمتوافقة مع الخاصيةdisplayNameفي طلب JSON والاستجابة.
  • اختيارياً، يمكنك تعيين المعلمة logging. قم بتعيين هذا على enabled لتمكين التسجيل الصوتي والتشخيصي لحركة مرور نقطة النهاية. الافتراضي هو false.

في ما يلي مثال على أمر Speech CLI لإنشاء نقطة نهاية وتوزيع نموذج:

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

يجب أن تتلقى نص الاستجابة بالتنسيق التالي:

{
  "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"
}

خاصية المستوى الأعلى self في نص الاستجابة هي URI لنقطة النهاية. استخدم URI هذا للحصول على تفاصيل بشأن مشروع نقطة النهاية ونموذجها وسجلاتها. يمكنك أيضاً استخدام URI هذا لتحديث نقطة النهاية.

للحصول على تعليمات Speech CLI مع نقاط النهاية، قم بتشغيل الأمر التالي:

spx help csr endpoint

لإنشاء نقطة نهاية ونشر نموذج، استخدم عملية Endpoints_Create من Speech to text REST API. إنشاء نص الطلب وفقًا للإرشادات التالية:

  • تعيين الخاصية project إلى URI لمشروع موجود. يوصى بذلك حتى يمكنك أيضاً عرض نقطة النهاية وإدارتها في Speech Studio. يمكنك تقديم طلب Projects_List للحصول على المشاريع المتوفرة.
  • قم بتعيين خاصية model المطلوبة إلى URI للنموذج الذي تريد توزيعه إلى نقطة النهاية.
  • عيّن الخاصية locale المطلوبة. يجب أن تتطابق لغة نقطة النهاية مع الإعدادات المحلية للنموذج. لا يمكن تغيير الإعدادات المحلية لاحقًا.
  • عيّن الخاصية displayName المطلوبة. هذا هو الاسم الذي يتم عرضه في Speech Studio.
  • اختيارياً، يمكنك تعيين خاصية loggingEnabled داخل properties. قم بتعيين هذا على true لتمكين التسجيل الصوتي والتشخيصي لحركة مرور نقطة النهاية. الافتراضي هو false.

قم بإجراء طلب HTTP POST باستخدام URI كما هو موضح في مثال Endpoints_Create التالي. استبدل YourSubscriptionKey بمفتاح مورد الكلام لديك، واستبدل YourServiceRegion بمنطقة مورد الكلام، وعيّن خصائص نص الطلب كما هو موضح سابقاً.

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"

يجب أن تتلقى نص الاستجابة بالتنسيق التالي:

{
  "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"
}

خاصية المستوى الأعلى self في نص الاستجابة هي URI لنقطة النهاية. استخدم URI هذا للحصول على تفاصيل بشأن مشروع نقطة النهاية ونموذجها وسجلاتها. يمكنك أيضاً استخدام URI هذا لتحديث أو حذف نقطة النهاية.

تغيير النموذج وإعادة توزيع نقطة النهاية

يمكن تحديث نقطة النهاية لاستخدام نموذج آخر تم إنشاؤه بواسطة نفس مصدر الكلام. كما ذكرنا سابقاً، يجب تحديث نموذج نقطة النهاية قبل انتهاء صلاحية النموذج.

لاستخدام نموذج جديد وإعادة توزيع نقطة النهاية المخصصة:

  1. سجّل الدخول إلـى Speech Studio.
  2. حدد الكلام> المخصص اسم >المشروع نشر النماذج.
  3. حدد الارتباط إلى نقطة نهاية بالاسم، ثم حدد Change model.
  4. حدد النموذج الجديد الذي تريد أن تستخدمه نقطة النهاية.
  5. حدد Done لحفظ وإعادة توزيع نقطة النهاية.

لإعادة توزيع نقطة النهاية المخصصة بنموذج جديد، استخدم الأمر spx csr model update. أنشئ عمليات الطلب وفقاً للتعليمات التالية:

  • قم بتعيين معلمة endpoint المطلوبة لمعرف نقطة النهاية التي تريد توزيعها.
  • قم بتعيين معلمة model المطلوبة لمعرف النموذج الذي تريد توزيعه إلى نقطة النهاية.

في ما يلي مثال لأمر Speech CLI الذي يعيد توزيع نقطة النهاية المخصصة بنموذج جديد:

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

يجب أن تتلقى نص الاستجابة بالتنسيق التالي:

{
  "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"
}

للحصول على تعليمات Speech CLI مع نقاط النهاية، قم بتشغيل الأمر التالي:

spx help csr endpoint

لإعادة نشر نقطة النهاية المخصصة باستخدام نموذج جديد، استخدم عملية Endpoints_Update من Speech to text REST API. إنشاء نص الطلب وفقًا للإرشادات التالية:

  • قم بتعيين الخاصية model إلى URI للنموذج الذي تريد توزيعه إلى نقطة النهاية.

يمكنك تقديم طلب HTTP PATCH باستخدام URI كما هو موضح في المثال التالي. استبدل YourSubscriptionKey بمفتاح مورد الكلام، واستبدل YourServiceRegion بمنطقة موارد الكلام، واستبدل YourEndpointId بمعرف نقطة النهاية، وقم بتعيين خصائص نص الطلب كما هو موضح سابقاً.

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"

يجب أن تتلقى نص الاستجابة بالتنسيق التالي:

{
  "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"
}

تستغرق إعادة الانتشار عدة دقائق حتى تكتمل. في هذه الأثناء، تستخدم نقطة النهاية النموذج السابق دون انقطاع الخدمة.

عرض بيانات التسجيل

بيانات التسجيل متاحة للتصدير إذا قمت بتكوينها في أثناء إنشاء نقطة النهاية.

لتنزيل سجلات نقطة النهاية:

  1. سجّل الدخول إلـى Speech Studio.
  2. حدد الكلام> المخصص اسم >المشروع نشر النماذج.
  3. حدد الارتباط باسم نقطة النهاية.
  4. ضمن Content logging، حدد Download log.

للحصول على سجلات لنقطة نهاية، استخدم spx csr endpoint list الأمر . أنشئ عمليات الطلب وفقاً للتعليمات التالية:

  • قم بتعيين معلمة endpoint المطلوبة لمعرف نقطة النهاية التي تريد الحصول على السجلات.

في ما يلي مثال على أمر Speech CLI يحصل على سجلات لنقطة نهاية:

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

يتم إرجاع مواقع كل ملف سجل بمزيد من التفاصيل في نص الاستجابة.

للحصول على سجلات لنقطة نهاية، ابدأ باستخدام Endpoints_Get تشغيل Speech to text REST API.

قم بإجراء طلب HTTP GET باستخدام URI كما هو موضح في المثال التالي. استبدل YourEndpointId بمعرف نقطة النهاية، واستبدل YourSubscriptionKey بمفتاح مورد الكلام، واستبدل YourServiceRegion بمنطقة موارد Speech.

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

يجب أن تتلقى نص الاستجابة بالتنسيق التالي:

{
  "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 باستخدام عنوان URI "للسجلات" من نص الاستجابة السابق. استبدل YourEndpointId بمعرف نقطة النهاية، واستبدل YourSubscriptionKey بمفتاح مورد الكلام، واستبدل YourServiceRegion بمنطقة موارد Speech.

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

يتم إرجاع مواقع كل ملف سجل بمزيد من التفاصيل في نص الاستجابة.

تتوفر بيانات التسجيل على التخزين المملوك ل Microsoft لمدة 30 يوما، ثم تتم إزالتها. إذا كان حساب التخزين الخاص بك مرتبطا باشتراك خدمات Azure الذكاء الاصطناعي، فلن يتم حذف بيانات التسجيل تلقائيا.

الخطوات التالية