Amaç tahminleri için sorgu dağıtımı

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. Dağıtımı program aracılığıyla Tahmin API'sini veya İstemci kitaplıkları (Azure SDK) 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.

Modelinizi Language Studio'dan test etmek için

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

2. Test etmek istediğiniz modeli seçin. Yalnızca dağıtımlara atanan modelleri test edebilirsiniz.

3. Dağıtım adı açılan listesinden dağıtım adınızı seçin.

4. Metin kutusuna test etmek için bir konuşma girin.

5. Üstteki menüden 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 kartları görünümünde veya JSON biçiminde görüntüleyebilirsiniz.

   

---

Düzenleme iş akışı 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. öğesini, amaçları ve varlıkları ayıklamak için göndermek istediğiniz gerçek metinle değiştirin <YOUR_QUERY_HERE> .

3. 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

Düzenleme iş akışı 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": {
      "text": "Text1",
      "participantId": "1",
      "id": "1"
    }
  },
  "parameters": {
    "projectName": "{PROJECT-NAME}",
    "deploymentName": "{DEPLOYMENT-NAME}",
    "directTarget": "qnaProject",
    "targetProjectParameters": {
      "qnaProject": {
        "targetProjectKind": "QuestionAnswering",
        "callingOptions": {
          "context": {
            "previousUserQuery": "Meet Surface Pro 4",
            "previousQnaId": 4
          },
          "top": 1,
          "question": "App Service overview"
        }
      }
    }
  }
}

Yanıt Gövdesi

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

{
  "kind": "ConversationResult",
  "result": {
    "query": "App Service overview",
    "prediction": {
      "projectKind": "Orchestration",
      "topIntent": "qnaTargetApp",
      "intents": {
        "qnaTargetApp": {
          "targetProjectKind": "QuestionAnswering",
          "confidenceScore": 1,
          "result": {
            "answers": [
              {
                "questions": [
                  "App Service overview"
                ],
                "answer": "The compute resources you use are determined by the *App Service plan* that you run your apps on.",
                "confidenceScore": 0.7384000000000001,
                "id": 1,
                "source": "https://learn.microsoft.com/azure/app-service/overview",
                "metadata": {},
                "dialog": {
                  "isContextOnly": false,
                  "prompts": []
                }
              }
            ]
          }
        }
      }
    }
  }
}

İstemci kitaplıkları (Azure SDK)

İ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.

İ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

• Düzenleme iş akışına genel bakış