Analiz yöntemiAnalyze Method

Önemli

Dilbilimsel Analiz önizleme sürümü 9 Ağustos 2018 tarihinde kullanımdan kaldırılmıştır.The Linguistic Analysis preview was decommissioned on August 9, 2018. Metin işleme ve analiz için Azure Machine Learning metin analizi modüllerini kullanmanızı öneririz.We recommend using Azure Machine Learning text analytics modules for text processing and analysis.

Analiz REST API, verilen doğal dil giriş analiz etmek için kullanılır.The analyze REST API is used to analyze a given natural language input. Yalnızca bulma ilgili tümce ve belirteçlere ayırmaktır içinde giriş, bulma konuşma bölümü etiketleri, veya bulma constituency ağaç.That might involve just finding the sentences and tokens within that input, finding the part-of-speech tags, or finding the constituency tree. İlgili Çözümleyicileri seçerek istediğiniz hangi sonuçları belirtebilirsiniz.You can specify which results you want by picking the relevant analyzers. Tüm kullanılabilir Çözümleyicileri listesine bakmak Çözümleyicileri .To list all available analyzers, look at the analyzers.

Giriş dizesinin dilini belirtmek gerektiğini unutmayın.Note that you need to specify the language of the input string.

REST uç noktası:REST endpoint:

https://westus.api.cognitive.microsoft.com/linguistics/v1.0/analyze

İstek parametreleriRequest parameters

AdName TypeType GerekliRequired AçıklamaDescription
Dillanguage stringstring EvetYes İki harfli ISO dil kod'analiz için kullanılacak.The two letter ISO language code to be used for analysis. Örneğin, "en" İngilizce olarak belirlenmiştir.For instance, English is "en".
analyzerIdsanalyzerIds dize listesilist of strings EvetYes Çözümleyiciler, uygulamak için bir GUID'ler listesi.List of GUIDs of analyzers to apply. Daha fazla bilgi için Çözümleyicileri belgelerine bakın.See the Analyzers documentation for more information.
texttext stringstring EvetYes Analiz edilecek ham giriş.Raw input to be analyzed. Bu, bir sözcük veya tümceciği, tam bir cümle veya paragraf tam veya discourse gibi kısa bir dize olabilir.This might be a short string such as a word or phrase, a full sentence, or a full paragraph or discourse.

Yanıt (JSON)Response (JSON)

Analiz çıkış dizisi, istekte belirtilen her bir öznitelik için bir tane.An array of analysis outputs, one for each attribute specified in the request.

Sonuçlar şu şekilde görünür:The results look as follows:

AdName TürType AçıklamaDescription
AnalyzerıdanalyzerId stringstring Belirtilen Çözümleyicisi GUİD'siGUID of the analyzer specified
Sonuçresult objectobject Çözümleyici sonucuanalyzer result

Sonuç türü giriş Çözümleyicisi türüne bağlı olduğunu unutmayın.Note that the type of the result depends on the input analyzer type.

Belirteçler yanıt (JSON)Tokens Response (JSON)

AdName TürType AçıklamaDescription
Sonuçresult tümce nesnelerinin listesilist of sentence objects içinde bulunan metinde tanımlanmış cümleyi sınırlarısentence boundaries identified within the text
[x] sonucu. Uzaklıkresult[x].Offset intint Her cümle başlangıç karakteri uzaklığıstarting character offset of each sentence
[x] sonucu. Lenresult[x].Len intint Her cümle karakter uzunluğulength in characters of each sentence
[x] sonucu. Belirteçleriresult[x].Tokens belirteç nesnelerinin listesilist of token objects belirteç sınırları tanımlanmış cümleyi içindetoken boundaries identified within the sentence
[x] sonucu. Belirteçler [y]. Uzaklıkresult[x].Tokens[y].Offset intint belirtecin başlangıç karakteri uzaklığıstarting character offset of the token
[x] sonucu. Belirteçler [y]. Lenresult[x].Tokens[y].Len intint belirtecin karakter uzunluğulength in characters of the token
[x] sonucu. Belirteçler [y]. RawTokenresult[x].Tokens[y].RawToken stringstring normalleştirme önce bu belirteci içindeki karakterlerthe characters inside that token, before normalization
[x] sonucu. Belirteçler [y]. NormalizedTokenresult[x].Tokens[y].NormalizedToken stringstring Normalleştirilmiş bir form karakterin kullanmak üzere güvenli bir ayrıştırma ağacı; Örneğin, bir açık parantez karakteri ' (' '- LRB-' olura normalized form of the character, safe for use in a parse tree; for instance, an open parenthesis character '(' becomes '-LRB-'

Örnek Giriş: ' Bu bir denemedir.Example input: `This is a test. Merhaba.'Hello.' Örnek JSON yanıtı:Example JSON response:

[
  {
    "Len": 15,
    "Offset": 0,
    "Tokens": [
      {
        "Len": 4,
        "NormalizedToken": "This",
        "Offset": 0,
        "RawToken": "This"
      },
      {
        "Len": 2,
        "NormalizedToken": "is",
        "Offset": 5,
        "RawToken": "is"
      },
      {
        "Len": 1,
        "NormalizedToken": "a",
        "Offset": 8,
        "RawToken": "a"
      },
      {
        "Len": 4,
        "NormalizedToken": "test",
        "Offset": 10,
        "RawToken": "test"
      },
      {
        "Len": 1,
        "NormalizedToken": ".",
        "Offset": 14,
        "RawToken": "."
      }
    ]
  },
  {
    "Len": 6,
    "Offset": 16,
    "Tokens": [
      {
        "Len": 5,
        "NormalizedToken": "Hello",
        "Offset": 16,
        "RawToken": "Hello"
      },
      {
        "Len": 1,
        "NormalizedToken": ".",
        "Offset": 21,
        "RawToken": "."
      }
    ]
  }
]

POS etiketleri yanıt (JSON)POS Tags Response (JSON)

Sonuç, dizeleri listesini bir listesidir.The result is list of lists of strings. Her bir cümle için listesini POS etiketleri, her bir belirteç için bir POS etiketi yoktur.For each sentence, there is a list of POS tags, one POS tag for each token. Belirteç karşılık gelen her bir POS etiketi bulmak için de simgeleştirme nesne için sorun isteyebilirsiniz.To find the token corresponding to each POS tag, you'll want to ask for a tokenization object as well.

Constituency ağaç yanıt (JSON)Constituency Tree Response (JSON)

Sonucu olan bir dize listesi, girişte her bir cümle için bir ayrıştırma ağacı.The result is a list of strings, one parse tree for each sentence found in the input. Ayrıştırma ağaçlarını, parantez içine alınmış biçimde temsil edilir.The parse trees are represented in a parenthesized form.

ÖrnekExample

POST /analyze

İstek gövdesi: JSON yüküRequest Body: JSON payload

{
  "language": "en",
  "analyzerIds": [
    "4FA79AF1-F22C-408D-98BB-B7D7AEEF7F04",
    "22A6B758-420F-4745-8A3C-46835A67C0D2" ],
  "text": "Hi, Tom! How are you today?"
}

Yanıt: JSONResponse: JSON

[
  {
    "analyzerId": "4FA79AF1-F22C-408D-98BB-B7D7AEEF7F04",
    "result": [ ["NNP",",","NNP","."], ["WRB","VBP","PRP","NN","."] ]
  },
  {
    "analyzerId": "22A6B758-420F-4745-8A3C-46835A67C0D2",
    "result":["(TOP (S (NNP Hi) (, ,) (NNP Tom) (. !)))","(TOP (SBARQ (WHADVP (WRB How)) (SQ (VP (VBP are)) (NP (PRP you)) (NN today) (. ?))))"]
  }
]