Dağıtıma tahmin istekleri gönderme

Dağıtım başarıyla eklendikten sonra dağıtıma atadığınız modele göre konuşmanızdan amaç ve varlık tahminleri için dağıtımı sorgulayabilirsiniz. Tahmin API'sini veya istemci kitaplıklarını (Azure SDK) kullanarak dağıtımı program aracılığıyla sorgulayabilirsiniz.

Dağıtılan modeli test etme

Language Studio'yu kullanarak konuşma gönderebilir, tahminler alabilir ve sonuçları görselleştirebilirsiniz.

Dağıtılan modellerinizi Language Studio'dan test etmek için:

1. Sol taraftaki menüden Test dağıtımları'nı seçin.

2. Çok dilli projeler için Metin dili seçin açılan listesinde test ettiğiniz konuşmanın dilini seçin.

3. Dağıtım adı açılan listesinden test etmek istediğiniz modele karşılık gelen dağıtım adını seçin. Yalnızca dağıtımlara atanan modelleri test edebilirsiniz.

4. Metin kutusuna test etmek için bir konuşma girin. Örneğin, e-postayla ilgili konuşmalar için bir uygulama oluşturduysanız Bu e-postayı sil girebilirsiniz.

5. Sayfanın üst kısmında Testi çalıştır'ı seçin.

6. Testi çalıştırdıktan sonra, sonuçta modelin yanıtını görmeniz gerekir. Sonuçları varlıklar kart görünümünde veya JSON biçiminde görüntüleyebilirsiniz.

---

Konuşma dili anlama isteği gönderme

Language Studio

1. Dağıtım işi başarıyla tamamlandıktan sonra, kullanmak istediğiniz dağıtımı seçin ve üst menüden Tahmin URL'sini al'ı seçin.

   

2. Görüntülenen pencerede, örnek istek URL'sini ve gövdesini komut satırınıza kopyalayın.

3. öğesini, amaçları ve varlıkları ayıklamak için göndermek istediğiniz gerçek metinle değiştirin <YOUR_QUERY_HERE> .

4. POST Terminalinizde veya komut isteminizde cURL isteğini gönderin. İstek başarılı olursa API sonuçlarını içeren bir 202 yanıtı alırsınız.

REST API'leri

İlk olarak kaynak anahtarınızı ve uç noktanızı almanız gerekir:

Azure portal kaynağınıza genel bakış sayfasına gidin. Sol taraftaki menüden Anahtarlar ve Uç Nokta'yı seçin. API istekleri için uç noktayı ve anahtarı kullanacaksınız

Modelinizi sorgulama

Konuşma dili anlama modelini test etmeye başlamak için aşağıdaki URL'yi, üst bilgileri ve JSON gövdesini kullanarak bir POST isteği oluşturun.

İstek URL’si

{ENDPOINT}/language/:analyze-conversations?api-version={API-VERSION}

Yer tutucu	Değer	Örnek
{ENDPOINT}	API isteğinizin kimliğini doğrulamak için uç nokta.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{API-VERSION}	Çağırdığınız API'nin sürümü .	2023-04-01

Üst Bilgiler

İsteğinizin kimliğini doğrulamak için aşağıdaki üst bilgiyi kullanın.

Anahtar	Değer
Ocp-Apim-Subscription-Key	Kaynağınızın anahtarı. API isteklerinizin kimliğini doğrulamak için kullanılır.

İstek gövdesi

{
  "kind": "Conversation",
  "analysisInput": {
    "conversationItem": {
      "id": "1",
      "participantId": "1",
      "text": "Text 1"
    }
  },
  "parameters": {
    "projectName": "{PROJECT-NAME}",
    "deploymentName": "{DEPLOYMENT-NAME}",
    "stringIndexType": "TextElement_V8"
  }
}

Anahtar	Yer tutucu	Değer	Örnek
participantId	{JOB-NAME}		"MyJobName
id	{JOB-NAME}		"MyJobName
text	{TEST-UTTERANCE}	Amacını tahmin etmek ve varlık ayıklamak istediğiniz konuşma.	"Read Matt's email
projectName	{PROJECT-NAME}	Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır.	myProject
deploymentName	{DEPLOYMENT-NAME}	Dağıtımınızın adı. Bu değer büyük/küçük harfe duyarlıdır.	staging

İsteği gönderdikten sonra tahmin için aşağıdaki yanıtı alırsınız

Yanıt gövdesi

{
  "kind": "ConversationResult",
  "result": {
    "query": "Text1",
    "prediction": {
      "topIntent": "inten1",
      "projectKind": "Conversation",
      "intents": [
        {
          "category": "intent1",
          "confidenceScore": 1
        },
        {
          "category": "intent2",
          "confidenceScore": 0
        },
        {
          "category": "intent3",
          "confidenceScore": 0
        }
      ],
      "entities": [
        {
          "category": "entity1",
          "text": "text1",
          "offset": 29,
          "length": 12,
          "confidenceScore": 1
        }
      ]
    }
  }
}

Anahtar	Örnek Değer	Description
query	"Matt'in e-postasını okuyun"	sorgu için gönderdiğiniz metin.
topIntent	"Oku"	En yüksek güvenilirlik puanına sahip tahmin edilen amaç.
Niyet	[]	Her birinin güvenilirlik puanına sahip sorgu metni için tahmin edilen tüm amaçların listesi.
Varlık	[]	sorgu metninden ayıklanan varlıkların listesini içeren dizi.

Konuşma projesi için API yanıtı

Konuşmalar projesinde hem amaçlarınız hem de projenizde bulunan varlıklar için tahminler alırsınız.

• Amaçlar ve varlıklar, modelin projenizdeki belirli bir öğeyi tahmin etme konusunda ne kadar emin olduğuyla ilişkili 0,0 ile 1,0 arasında bir güvenilirlik puanı içerir.
• En üst puanlama amacı kendi parametresi içinde yer alır.
• Yanıtınızda yalnızca tahmin edilen varlıklar gösterilir.
• Varlıklar şu şekildedir:
  • Ayıklanan varlığın metni
  • Uzaklık değeriyle belirtilen başlangıç konumu
  • Uzunluk değeriyle belirtilen varlık metninin uzunluğu.

İstemci kitaplıkları (Azure SDK)

İstemci kitaplıklarını kullanma (Azure SDK)

Modelinize istek göndermek için Azure SDK tarafından sağlanan istemci kitaplıklarını da kullanabilirsiniz.

Not

Konuşma dili anlama için istemci kitaplığı yalnızca şu durumlarda kullanılabilir:

• .NET
• Python

1. Azure portal kaynağınıza genel bakış sayfasına gidin

2. Sol taraftaki menüden Anahtarlar ve Uç Nokta'yı seçin. API istekleri için uç nokta kullandığınızda üst bilgi anahtarına Ocp-Apim-Subscription-Key ihtiyacınız olacaktır.

   

3. seçtiğiniz dil için istemci kitaplığı paketini indirin ve yükleyin:

   Dil	Paket sürümü
   .NET	1.0.0
   Python	1.0.0

4. İstemci kitaplığını yükledikten sonra, API'yi çağırmaya başlamak için GitHub'da aşağıdaki örnekleri kullanın.

   • C#
   • Python

5. Daha fazla bilgi için aşağıdaki başvuru belgelerine bakın:

   • C#
   • Python

Sonraki adımlar

• Konuşma dilini anlamaya genel bakış