Szöveg elemzése (Azure AI Search REST API)

  • Cikk

Az Analyze API bemutatja, hogy az elemzők hogyan törik fel a szöveget jogkivonatokká. Interaktív tesztelésre szolgál, így láthatja, hogyan fogja egy adott elemző tokenizálni a sztringbemenetet.

POST https://[service name].search.windows.net/indexes/[index name]/analyze?api-version=[api-version]
    Content-Type: application/json
    api-key: [admin key]

Az indexelés és a lekérdezés végrehajtása során használt elemző megadásához állítsa be az elemző tulajdonságot az index sztringmezőire.

URI-paraméterek

Paraméter Leírás
szolgáltatásnév Kötelező. Állítsa be ezt a keresési szolgáltatás egyedi, felhasználó által definiált nevére.
index neve Kötelező. A kérelem URI-ja megadja az elemezni kívánt mezőt tartalmazó index nevét.
api-verzió Kötelező. A jelenlegi stabil verzió a következő api-version=2020-06-30: . További verziókért lásd: API-verziók .

Kérelemfejlécek

Az alábbi táblázat a szükséges és nem kötelező kérésfejléceket ismerteti.

Mezők Description
Content-Type Kötelező. Állítsa a következőre: application/json
api-key Nem kötelező , ha Azure-szerepköröket használ, és egy tulajdonosi jogkivonatot ad meg a kéréshez, ellenkező esetben kulcsra van szükség. Az API-kulcs egy egyedi, rendszer által generált sztring, amely hitelesíti a kérést a keresési szolgáltatásnak. Az elemzők kéréseinek tartalmazniuk kell egy api-key fejlécet a rendszergazdai kulcshoz (a lekérdezési kulcs helyett). A részletekért lásd: Csatlakozás az Azure AI Search szolgáltatáshoz kulcshitelesítés használatával .

Kérelem törzse

{
  "text": "Text to analyze",
  "analyzer": "analyzer_name"
}

vagy

{
  "text": "Text to analyze",
  "tokenizer": "tokenizer_name",
  "tokenFilters": (optional) [ "token_filter_name" ],
  "charFilters": (optional) [ "char_filter_name" ]
}

A analyzer_name, tokenizer_nametoken_filter_name és char_filter_name érvényesnek kell lennie az index előre definiált vagy egyéni elemzőinek, jogkivonat-elemzőinek, jogkivonatszűrőinek és karakterszűrőinek. A lexikális elemzés folyamatával kapcsolatos további információkért lásd: Elemzés az Azure AI Searchben.

Reagálás

Állapotkód: Sikeres válasz esetén a rendszer 200 OK értéket ad vissza.

A válasz törzse a következő formátumban van:

    {
      "tokens": [
        {
          "token": string (token),
          "startOffset": number (index of the first character of the token),
          "endOffset": number (index of the last character of the token),
          "position": number (position of the token in the input text)
        },
        ...
      ]
    }

Példák

A kérelemtörzs tartalmazza a használni kívánt sztringet és elemzőt.

     {
       "text": "The quick brown fox",
       "analyzer": "standard"
     }

A válasz az elemző által a megadott sztringhez kibocsátott jogkivonatokat jeleníti meg.

{
    "tokens": [
        {
            "token": "the",
            "startOffset": 0,
            "endOffset": 3,
            "position": 0
        },
        {
            "token": "quick",
            "startOffset": 4,
            "endOffset": 9,
            "position": 1
        },
        {
            "token": "brown",
            "startOffset": 10,
            "endOffset": 15,
            "position": 2
        },
        {
            "token": "fox",
            "startOffset": 16,
            "endOffset": 19,
            "position": 3
        }
    ]
}

Lásd még