Szöveg elemzése (Azure AI Search REST API)
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
}
]
}