Documents - Search Get
Cerca i documenti nell'indice.
GET {endpoint}/indexes('{indexName}')/docs?api-version=2024-05-01-preview
GET {endpoint}/indexes('{indexName}')/docs?search={search}&$count={$count}&facet={facet}&$filter={$filter}&highlight={highlight}&highlightPostTag={highlightPostTag}&highlightPreTag={highlightPreTag}&minimumCoverage={minimumCoverage}&$orderby={$orderby}&queryType={queryType}&scoringParameter={scoringParameter}&scoringProfile={scoringProfile}&searchFields={searchFields}&searchMode={searchMode}&scoringStatistics={scoringStatistics}&sessionId={sessionId}&$select={$select}&$skip={$skip}&$top={$top}&api-version=2024-05-01-preview&semanticConfiguration={semanticConfiguration}&semanticErrorHandling={semanticErrorHandling}&semanticMaxWaitInMilliseconds={semanticMaxWaitInMilliseconds}&answers={answers}&captions={captions}&semanticQuery={semanticQuery}&debug={debug}&queryLanguage={queryLanguage}&speller={speller}&semanticFields={semanticFields}
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
endpoint
|
path | True |
string |
URL dell'endpoint del servizio di ricerca. |
index
|
path | True |
string |
Nome dell'indice. |
api-version
|
query | True |
string |
Versione dell'API client. |
$count
|
query |
boolean |
Valore che specifica se recuperare il conteggio totale dei risultati. L'impostazione predefinita è false. L'impostazione di questo valore su true può avere un impatto sulle prestazioni. Si noti che il conteggio restituito è un'approssimazione. |
|
$filter
|
query |
string |
L'espressione OData $filter da applicare alla query di ricerca. |
|
$orderby
|
query |
string[] |
Elenco di espressioni OData $orderby in base alla quale ordinare i risultati. Ogni espressione può essere un nome di campo o una chiamata alle funzioni geo.distance() o search.score(). Ogni espressione può essere seguita da asc per indicare l'ordine crescente e desc per indicare la decrescente. Per impostazione predefinita, l'ordinamento è crescente. Le situazioni di parità di priorità vengono risolte in base ai punteggi di corrispondenza dei documenti. Se non viene specificato alcun orderBy, l'ordinamento predefinito è decrescente in base al punteggio di corrispondenza del documento. Possono essere presenti al massimo 32 clausole $orderby. |
|
$select
|
query |
string[] |
Elenco di campi da recuperare. Se non è specificato, vengono inclusi tutti i campi contrassegnati come recuperabili nello schema. |
|
$skip
|
query |
integer int32 |
Numero di risultati della ricerca da ignorare. Questo valore non può essere maggiore di 100.000. Se è necessario analizzare i documenti in sequenza, ma non è possibile usare $skip a causa di questa limitazione, è consigliabile usare $orderby su una chiave completamente ordinata e $filter con una query di intervallo. |
|
$top
|
query |
integer int32 |
Numero di risultati della ricerca da recuperare. Questa operazione può essere usata in combinazione con $skip per implementare il paging lato client dei risultati della ricerca. Se i risultati vengono troncati a causa del paging lato server, la risposta includerà un token di continuazione che può essere usato per inviare un'altra richiesta di ricerca per la pagina successiva dei risultati. |
|
answers
|
query |
Questo parametro è valido solo se il tipo di query è |
||
captions
|
query |
Questo parametro è valido solo se il tipo di query è |
||
debug
|
query |
Abilita uno strumento di debug che può essere usato per esplorare ulteriormente i risultati della ricerca. |
||
facet
|
query |
string[] |
Elenco di espressioni facet da applicare alla query di ricerca. Ogni espressione facet contiene un nome di campo, seguito facoltativamente da un elenco delimitato da virgole di coppie nome:valore. |
|
highlight
|
query |
string[] |
Elenco di nomi di campo da usare per le evidenziazioni dei risultati. Solo i campi ricercabili possono essere usati per l'evidenziazione dei risultati. |
|
highlight
|
query |
string |
Tag stringa aggiunto per l'hit highlights. Deve essere impostato con highlightPreTag. Il valore predefinito è </em>. |
|
highlight
|
query |
string |
Tag stringa anteporto ai punti di evidenziazione. Deve essere impostato con highlightPostTag. Il valore predefinito è <em>. |
|
minimum
|
query |
number double |
Numero compreso tra 0 e 100 che indica la percentuale dell'indice che deve essere coperta da una query di ricerca affinché la query venga segnalata come riuscita. Questo parametro può essere utile per garantire la disponibilità della ricerca anche per i servizi con una sola replica. Il valore predefinito è 100. |
|
query
|
query |
Lingua della query. |
||
query
|
query |
Valore che specifica la sintassi della query di ricerca. Il valore predefinito è "semplice". Usare "full" se la query usa la sintassi della query Lucene. |
||
scoring
|
query |
string[] |
Elenco dei valori dei parametri da usare nelle funzioni di assegnazione dei punteggi (ad esempio, referencePointParameter) usando i valori dei nomi di formato. Ad esempio, se il profilo di assegnazione dei punteggi definisce una funzione con un parametro denominato "mylocation", la stringa di parametro sarebbe "mylocation--122.2.44.8" (senza virgolette). |
|
scoring
|
query |
string |
Nome di un profilo di punteggio da usare per la valutazione di punteggi di corrispondenza per i documenti corrispondenti, in modo da ordinare i risultati. |
|
scoring
|
query |
Valore che specifica se si desidera calcolare le statistiche di assegnazione dei punteggi (ad esempio la frequenza del documento) a livello globale per un punteggio più coerente o locale, per una latenza inferiore. |
||
search
|
query |
string |
Espressione di query di ricerca full-text; Usare "*" o omettere questo parametro per trovare la corrispondenza con tutti i documenti. |
|
search
|
query |
string[] |
Elenco di nomi di campi a cui definire l'ambito della ricerca full-text. Quando si usa la ricerca in campi (fieldName:searchExpression) in una query Lucene completa, i nomi di campo di ogni espressione di ricerca a campi hanno la precedenza su tutti i nomi di campo elencati in questo parametro. |
|
search
|
query |
Valore che specifica se qualsiasi o tutti i termini di ricerca devono essere corrispondenti per contare il documento come corrispondenza. |
||
semantic
|
query |
string |
Nome della configurazione semantica che elenca i campi da usare per la classificazione semantica, le didascalie, le evidenziazioni e le risposte |
|
semantic
|
query |
Consente all'utente di scegliere se una chiamata semantica deve avere esito negativo o restituire risultati parziali (impostazione predefinita). |
||
semantic
|
query |
string[] |
Elenco di nomi di campi usati per la classificazione semantica. |
|
semantic
|
query |
integer int32 |
Consente all'utente di impostare un limite superiore per la quantità di tempo necessario per l'arricchimento semantico per completare l'elaborazione prima che la richiesta non riesca. |
|
semantic
|
query |
string |
Consente di impostare una query di ricerca separata che verrà usata esclusivamente per la reranking semantica, le didascalie semantiche e le risposte semantiche. È utile per gli scenari in cui è necessario usare query diverse tra la fase di recupero e classificazione di base e la fase semantica L2. |
|
session
|
query |
string |
Valore da usare per creare una sessione sticky, che può aiutare a ottenere risultati più coerenti. Purché venga usato lo stesso sessionId, verrà eseguito un tentativo di sforzo ottimale per indirizzare lo stesso set di repliche. Tenere presente che il riutilizzo degli stessi valori sessionID può interferire ripetutamente con il bilanciamento del carico delle richieste tra repliche e influire negativamente sulle prestazioni del servizio di ricerca. Il valore usato come sessionId non può iniziare con un carattere '_'. |
|
speller
|
query |
Migliorare il richiamo della ricerca correggendo i singoli termini di query di ricerca. |
Intestazione della richiesta
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
x-ms-client-request-id |
string uuid |
ID di rilevamento inviato con la richiesta di assistenza per il debug. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Risposta contenente documenti che corrispondono ai criteri di ricerca. |
|
Other Status Codes |
Risposta di errore. |
Esempio
SearchIndexSearchDocumentsGet
Esempio di richiesta
GET https://myservice.search.windows.net/indexes('myindex')/docs?search=nice hotels&$count=True&facet=category,count:10,sort:count&$filter=rating gt 10&highlight=title&highlightPostTag=</em>&highlightPreTag=<em>&minimumCoverage=80&$orderby=search.score() desc,rating desc&queryType=simple&scoringProfile=sp&searchFields=title,description&searchMode=any&scoringStatistics=global&sessionId=mysessionid&$select=docId,title,description&$skip=100&$top=10&api-version=2024-05-01-preview&speller={speller}
Risposta di esempio
{
"@odata.count": 25,
"@search.coverage": 80,
"@search.facets": {
"category": [
{
"count": 1,
"value": "Economy"
},
{
"count": 1,
"value": "Luxury"
}
]
},
"value": [
{
"@search.score": 1.5,
"@search.highlights": {
"title": [
"<em>Nice</em> <em>Hotel</em>"
]
},
"description": "Cheapest hotel in town",
"docId": "1",
"title": "Nice Hotel"
},
{
"@search.score": 0.7,
"@search.highlights": {
"title": [
"Fancy <em>Hotel</em>"
]
},
"description": "Best hotel in town",
"docId": "2",
"title": "Fancy Hotel"
}
]
}
Definizioni
Nome | Descrizione |
---|---|
Answer |
Una risposta è un passaggio di testo estratto dal contenuto dei documenti più rilevanti che corrispondono alla query. Le risposte vengono estratte dai risultati principali della ricerca. I candidati alla risposta vengono assegnati punteggi e le risposte principali sono selezionate. |
Caption |
Le didascalie sono i passaggi più rappresentativi del documento relativamente alla query di ricerca. Vengono spesso usati come riepilogo dei documenti. Le didascalie vengono restituite solo per le query di tipo 'semantic'. |
Document |
Contiene informazioni di debug che possono essere usate per esplorare ulteriormente i risultati della ricerca. |
Error |
Informazioni aggiuntive sulla gestione delle risorse. |
Error |
Dettagli dell'errore. |
Error |
Risposta di errore |
Hybrid |
Determina se il conteggio e i facet devono includere tutti i documenti corrispondenti alla query di ricerca o solo i documenti recuperati all'interno della finestra 'maxTextRecallSize'. Il valore predefinito è 'countAllResults'. |
Hybrid |
I parametri di query per configurare i comportamenti di ricerca ibrida. |
Query |
Valore che specifica se le risposte devono essere restituite come parte della risposta di ricerca. |
Query |
Valore che specifica se le didascalie devono essere restituite come parte della risposta di ricerca. |
Query |
Abilita uno strumento di debug che può essere usato per esplorare ulteriormente i risultati della ricerca. |
Query |
Lingua della query. |
Query |
Stringhe concatenate non elaborate inviate al processo di arricchimento semantico. |
Query |
Descrizione dei campi inviati al processo di arricchimento semantico, nonché del modo in cui sono stati usati |
Query |
Valore che specifica il tipo del ortografico da usare per correggere in modo ortografico i singoli termini di query di ricerca. |
Query |
Specifica la sintassi della query di ricerca. Il valore predefinito è "semplice". Usare "full" se la query usa la sintassi della query Lucene e 'semantica' se la sintassi della query non è necessaria. |
Raw |
Parametri di query da usare per la ricerca vettoriale quando viene fornito un valore vettore non elaborato. |
Scoring |
Valore che specifica se si desidera calcolare le statistiche di assegnazione dei punteggi (ad esempio la frequenza del documento) a livello globale per un punteggio più coerente o locale, per una latenza inferiore. Il valore predefinito è "local". Usare "globale" per aggregare le statistiche di assegnazione dei punteggi a livello globale prima di assegnare punteggi. L'uso delle statistiche di assegnazione dei punteggi globali può aumentare la latenza delle query di ricerca. |
Search |
Risposta contenente i risultati della ricerca da un indice. |
Search |
Specifica se è necessario trovare una corrispondenza con uno o tutti i termini di ricerca per includere il documento nel numero delle corrispondenze. |
Search |
Parametri per il filtro, l'ordinamento, il facet, il paging e altri comportamenti delle query di ricerca. |
Search |
Contiene un documento trovato da una query di ricerca, oltre ai metadati associati. |
Search |
I risultati della query vettoriale verranno filtrati in base al valore "@search.score". Si noti che questo è l'oggetto @search.score restituito come parte della risposta di ricerca. La direzione della soglia verrà scelta per un valore superiore @search.score. |
Semantic |
|
Semantic |
Consente all'utente di scegliere se una chiamata semantica deve avere esito negativo o restituire risultati parziali (impostazione predefinita). |
Semantic |
Motivo per cui è stata restituita una risposta parziale per una richiesta di classificazione semantica. |
Semantic |
Modalità di utilizzo del campo per il processo di arricchimento semantico (completamente usato, parzialmente usato o inutilizzato) |
Semantic |
Tipo di risposta parziale restituita per una richiesta di classificazione semantica. |
Speller |
Migliorare il richiamo della ricerca correggendo i singoli termini di query di ricerca. |
Vector |
Determina se i filtri vengono applicati prima o dopo l'esecuzione della ricerca del vettore. |
Vectorizable |
Parametri di query da usare per la ricerca vettoriale quando viene fornito un file binario con codifica base 64 di un'immagine che deve essere vettorializzato. |
Vectorizable |
I parametri di query da usare per la ricerca vettoriale quando viene fornito un URL che rappresenta un valore di immagine che deve essere vettorializzato. |
Vectorizable |
I parametri di query da usare per la ricerca vettoriale quando viene fornito un valore di testo che deve essere vettorializzato. |
Vector |
Tipo di query vettoriale da eseguire. |
Vector |
I risultati della query vettoriale verranno filtrati in base alla metrica di somiglianza del vettore. Si noti che si tratta della definizione canonica della metrica di somiglianza, non della versione "distance". La direzione della soglia (maggiore o minore) verrà scelta automaticamente in base alla metrica usata dal campo. |
Vector |
Tipo di query vettoriale da eseguire. |
AnswerResult
Una risposta è un passaggio di testo estratto dal contenuto dei documenti più rilevanti che corrispondono alla query. Le risposte vengono estratte dai risultati principali della ricerca. I candidati alla risposta vengono assegnati punteggi e le risposte principali sono selezionate.
Nome | Tipo | Descrizione |
---|---|---|
highlights |
string |
Lo stesso passaggio di testo della proprietà Text con frasi di testo evidenziate più rilevanti per la query. |
key |
string |
Chiave del documento da cui è stata estratta la risposta. |
score |
number |
Il valore del punteggio rappresenta il modo in cui la risposta è pertinente alla query rispetto ad altre risposte restituite per la query. |
text |
string |
Il passaggio di testo estratto dal contenuto del documento come risposta. |
CaptionResult
Le didascalie sono i passaggi più rappresentativi del documento relativamente alla query di ricerca. Vengono spesso usati come riepilogo dei documenti. Le didascalie vengono restituite solo per le query di tipo 'semantic'.
Nome | Tipo | Descrizione |
---|---|---|
highlights |
string |
Stesso passaggio di testo della proprietà Text con frasi evidenziate più rilevanti per la query. |
text |
string |
Un passaggio di testo rappresentativo estratto dal documento più pertinente alla query di ricerca. |
DocumentDebugInfo
Contiene informazioni di debug che possono essere usate per esplorare ulteriormente i risultati della ricerca.
Nome | Tipo | Descrizione |
---|---|---|
semantic |
Contiene informazioni di debug specifiche per le richieste di classificazione semantica. |
ErrorAdditionalInfo
Informazioni aggiuntive sulla gestione delle risorse.
Nome | Tipo | Descrizione |
---|---|---|
info |
object |
Informazioni aggiuntive. |
type |
string |
Tipo di informazioni aggiuntive. |
ErrorDetail
Dettagli dell'errore.
Nome | Tipo | Descrizione |
---|---|---|
additionalInfo |
Informazioni aggiuntive sull'errore. |
|
code |
string |
Codice di errore. |
details |
Dettagli dell'errore. |
|
message |
string |
Messaggio di errore. |
target |
string |
Destinazione dell'errore. |
ErrorResponse
Risposta di errore
Nome | Tipo | Descrizione |
---|---|---|
error |
Oggetto error. |
HybridCountAndFacetMode
Determina se il conteggio e i facet devono includere tutti i documenti corrispondenti alla query di ricerca o solo i documenti recuperati all'interno della finestra 'maxTextRecallSize'. Il valore predefinito è 'countAllResults'.
Nome | Tipo | Descrizione |
---|---|---|
countAllResults |
string |
Includere tutti i documenti corrispondenti alla query di ricerca durante il calcolo di 'count' e 'facet', indipendentemente dal fatto che tali documenti si trovino o meno nella finestra di recupero 'maxTextRecallSize'. |
countRetrievableResults |
string |
Includere solo i documenti corrispondenti all'interno della finestra di recupero 'maxTextRecallSize' durante il calcolo di 'count' e 'facet'. |
HybridSearch
I parametri di query per configurare i comportamenti di ricerca ibrida.
Nome | Tipo | Descrizione |
---|---|---|
countAndFacetMode |
Determina se il conteggio e i facet devono includere tutti i documenti corrispondenti alla query di ricerca o solo i documenti recuperati all'interno della finestra "maxTextRecallSize". |
|
maxTextRecallSize |
integer |
Determina il numero massimo di documenti da recuperare dalla parte di query di testo di una richiesta di ricerca ibrida. Questi documenti verranno combinati con i documenti che corrispondono alle query vettoriali per produrre un unico elenco finale di risultati. La scelta di un valore maxTextRecallSize più grande consentirà il recupero e il paging di altri documenti (usando i parametri principali e ignora), a costo di un utilizzo delle risorse più elevato e una latenza maggiore. Il valore deve essere compreso tra 1 e 10.000. Il valore predefinito è 1000. |
QueryAnswerType
Valore che specifica se le risposte devono essere restituite come parte della risposta di ricerca.
Nome | Tipo | Descrizione |
---|---|---|
extractive |
string |
Estrae le risposte ai candidati dal contenuto dei documenti restituiti in risposta a una query espressa come domanda in linguaggio naturale. |
none |
string |
Non restituire risposte per la query. |
QueryCaptionType
Valore che specifica se le didascalie devono essere restituite come parte della risposta di ricerca.
Nome | Tipo | Descrizione |
---|---|---|
extractive |
string |
Estrae didascalie dai documenti corrispondenti che contengono passaggi rilevanti per la query di ricerca. |
none |
string |
Non restituire didascalie per la query. |
QueryDebugMode
Abilita uno strumento di debug che può essere usato per esplorare ulteriormente i risultati della ricerca.
Nome | Tipo | Descrizione |
---|---|---|
disabled |
string |
Non verranno restituite informazioni di debug delle query. |
semantic |
string |
Consente all'utente di esplorare ulteriormente i risultati rivalutati. |
QueryLanguage
Lingua della query.
Nome | Tipo | Descrizione |
---|---|---|
ar-eg |
string |
Valore della lingua di query per arabo (Egitto). |
ar-jo |
string |
Valore della lingua di query per arabo (Giordania). |
ar-kw |
string |
Valore della lingua di query per arabo (Kuwait). |
ar-ma |
string |
Valore della lingua di query per arabo (Marocco). |
ar-sa |
string |
Valore della lingua di query per arabo (Arabia Saudita). |
bg-bg |
string |
Valore della lingua di query per bulgaro (Bulgaria). |
bn-in |
string |
Valore del linguaggio di query per Bengali (India). |
ca-es |
string |
Valore della lingua di query per catalano. |
cs-cz |
string |
Valore del linguaggio di query per Il ceco (Repubblica Ceca). |
da-dk |
string |
Valore della lingua di query per danese (Danimarca). |
de-de |
string |
Valore della lingua di query per tedesco (Germania). |
el-gr |
string |
Valore della lingua di query per greco (Grecia). |
en-au |
string |
Valore della lingua di query per l'inglese (Australia). |
en-ca |
string |
Valore della lingua di query per l'inglese (Canada). |
en-gb |
string |
Valore della lingua di query per l'inglese (Gran Bretagna). |
en-in |
string |
Valore della lingua di query per l'inglese (India). |
en-us |
string |
Valore della lingua di query per l'inglese (Stati Uniti). |
es-es |
string |
Valore della lingua di query per spagnolo (Spagna). |
es-mx |
string |
Valore della lingua di query per spagnolo (Messico). |
et-ee |
string |
Valore della lingua di query per Estonian (Estonia). |
eu-es |
string |
Valore del linguaggio di query per basco. |
fa-ae |
string |
Valore della lingua di query per Persian (U.A.E.). |
fi-fi |
string |
Valore del linguaggio di query per finlandese (Finlandia). |
fr-ca |
string |
Valore della lingua di query per francese (Canada). |
fr-fr |
string |
Valore della lingua di query per francese (Francia). |
ga-ie |
string |
Valore della lingua di query per Irlandese (Irlanda). |
gl-es |
string |
Valore del linguaggio di query per La Galiziano. |
gu-in |
string |
Valore del linguaggio di query per Gujarati (India). |
he-il |
string |
Valore del linguaggio di query per ebraico (Israele). |
hi-in |
string |
Valore del linguaggio di query per Hindi (India). |
hr-ba |
string |
Valore della lingua di query per croato (Bosnia ed Erzegovina). |
hr-hr |
string |
Valore della lingua di query per la Croazia (Croazia). |
hu-hu |
string |
Valore della lingua di query per l'ungherese (Ungheria). |
hy-am |
string |
Valore del linguaggio di query per Armena (Armenia). |
id-id |
string |
Valore del linguaggio di query per Indonesiano (Indonesia). |
is-is |
string |
Valore del linguaggio di query per Islanda (Islanda). |
it-it |
string |
Valore della lingua di query per l'italiano (Italia). |
ja-jp |
string |
Valore della lingua di query per giapponese (Giappone). |
kn-in |
string |
Valore del linguaggio di query per Kannada (India). |
ko-kr |
string |
Valore del linguaggio di query per coreano (Corea). |
lt-lt |
string |
Valore della lingua di query per la Lituania (Lituania). |
lv-lv |
string |
Valore del linguaggio di query per lettone (Lettonia). |
ml-in |
string |
Valore del linguaggio di query per Malayalam (India). |
mr-in |
string |
Valore del linguaggio di query per Marathi (India). |
ms-bn |
string |
Valore del linguaggio di query per La malay (Brunei Darussalam). |
ms-my |
string |
Valore del linguaggio di query per malay (Malesia). |
nb-no |
string |
Valore del linguaggio di query per Norvegese (Norvegia). |
nl-be |
string |
Valore della lingua di query per l'olandese (Belgio). |
nl-nl |
string |
Valore della lingua di query per olandese (Paesi Bassi). |
no-no |
string |
Valore del linguaggio di query per Norvegese (Norvegia). |
none |
string |
Linguaggio di query non specificato. |
pa-in |
string |
Valore del linguaggio di query per Punjabi (India). |
pl-pl |
string |
Valore del linguaggio di query per il polacco (Polonia). |
pt-br |
string |
Valore della lingua di query per portoghese (Brasile). |
pt-pt |
string |
Valore della lingua di query per portoghese (Portogallo). |
ro-ro |
string |
Valore della lingua di query per romania (Romania). |
ru-ru |
string |
Valore della lingua di query per russo (Russia). |
sk-sk |
string |
Valore della lingua di query per slovacchia (Slovacchia). |
sl-sl |
string |
Valore della lingua di query per slovenia (Slovenia). |
sr-ba |
string |
Valore della lingua di query per il serbo (Bosnia ed Erzegovina). |
sr-me |
string |
Valore della lingua di query per il serbo (Montenegro). |
sr-rs |
string |
Valore della lingua di query per il serbo (Serbia). |
sv-se |
string |
Valore della lingua di query per svedese (Svezia). |
ta-in |
string |
Valore del linguaggio di query per Tamil (India). |
te-in |
string |
Valore del linguaggio di query per Telugu (India). |
th-th |
string |
Valore del linguaggio di query per Thai (Thailandia). |
tr-tr |
string |
Valore della lingua di query per turco (Turchia). |
uk-ua |
string |
Valore della lingua di query per ucraino (Ucraina). |
ur-pk |
string |
Valore del linguaggio di query per Urdu (Pakistan). |
vi-vn |
string |
Valore del linguaggio di query per il Vietnam (Viet Nam). |
zh-cn |
string |
Valore della lingua di query per cinese (Cina). |
zh-tw |
string |
Valore della lingua di query per cinese (Taiwan). |
QueryResultDocumentRerankerInput
Stringhe concatenate non elaborate inviate al processo di arricchimento semantico.
Nome | Tipo | Descrizione |
---|---|---|
content |
string |
Stringhe concatenate non elaborate per i campi di contenuto utilizzati per l'arricchimento semantico. |
keywords |
string |
Stringhe concatenate non elaborate per i campi parola chiave utilizzati per l'arricchimento semantico. |
title |
string |
Stringa non elaborata per il campo del titolo utilizzato per l'arricchimento semantico. |
QueryResultDocumentSemanticField
Descrizione dei campi inviati al processo di arricchimento semantico, nonché del modo in cui sono stati usati
Nome | Tipo | Descrizione |
---|---|---|
name |
string |
Nome del campo inviato al processo di arricchimento semantico |
state |
Modalità di utilizzo del campo per il processo di arricchimento semantico (completamente usato, parzialmente usato o inutilizzato) |
QuerySpellerType
Valore che specifica il tipo del ortografico da usare per correggere in modo ortografico i singoli termini di query di ricerca.
Nome | Tipo | Descrizione |
---|---|---|
lexicon |
string |
Il correttore ortografico corregge i singoli termini di query usando un lexicon statico per il linguaggio specificato dal parametro queryLanguage. |
none |
string |
Il correttore ortografico non è abilitato. |
QueryType
Specifica la sintassi della query di ricerca. Il valore predefinito è "semplice". Usare "full" se la query usa la sintassi della query Lucene e 'semantica' se la sintassi della query non è necessaria.
Nome | Tipo | Descrizione |
---|---|---|
full |
string |
Usa la sintassi completa della query Lucene per le ricerche. Il testo di ricerca viene interpretato usando il linguaggio di query Lucene che consente ricerche specifiche del campo e ponderate, nonché altre funzionalità avanzate. |
semantic |
string |
Ideale per le query espresse in linguaggio naturale anziché parole chiave. Migliora la precisione dei risultati della ricerca classificando nuovamente i risultati principali della ricerca usando un modello di classificazione sottoposto a training sul Web corpus. |
simple |
string |
Usa la sintassi di query semplice per le ricerche. Il testo di ricerca viene interpretato usando un linguaggio di query semplice che consente simboli come +, * e "". Le query vengono valutate in tutti i campi ricercabili per impostazione predefinita, a meno che non sia specificato il parametro searchFields. |
RawVectorQuery
Parametri di query da usare per la ricerca vettoriale quando viene fornito un valore vettore non elaborato.
Nome | Tipo | Descrizione |
---|---|---|
exhaustive |
boolean |
Se true, attiva una ricerca più vicina e completa tra tutti i vettori all'interno dell'indice vettore. Utile per gli scenari in cui le corrispondenze esatte sono critiche, ad esempio determinare i valori di verità di terra. |
fields |
string |
Campi vettoriali di tipo Collection(Edm.Single) da includere nel vettore cercato. |
k |
integer |
Numero di vicini più vicini da restituire come risultati principali. |
kind |
string:
vector |
Tipo di query vettoriale eseguita. |
oversampling |
number |
Fattore di sovrasampling. Il valore minimo è 1. Esegue l'override del parametro 'defaultOversampling' configurato nella definizione dell'indice. Può essere impostato solo quando 'rerankWithOriginalVectors' è true. Questo parametro è consentito solo quando viene usato un metodo di compressione nel campo vettore sottostante. |
threshold | VectorThreshold: |
Soglia usata per le query vettoriali. Nota che può essere impostato solo se tutti i 'campi' usano la stessa metrica di somiglianza. |
vector |
number[] |
Rappresentazione vettoriale di una query di ricerca. |
weight |
number |
Peso relativo della query vettore rispetto ad altre query vettoriali e/o alla query di testo all'interno della stessa richiesta di ricerca. Questo valore viene usato quando si combinano i risultati di più elenchi di classificazione generati dalle diverse query vettoriali e/o i risultati recuperati tramite la query di testo. Maggiore è il peso, più alto saranno i documenti corrispondenti alla query nella classifica finale. Il valore predefinito è 1,0 e il valore deve essere un numero positivo maggiore di zero. |
ScoringStatistics
Valore che specifica se si desidera calcolare le statistiche di assegnazione dei punteggi (ad esempio la frequenza del documento) a livello globale per un punteggio più coerente o locale, per una latenza inferiore. Il valore predefinito è "local". Usare "globale" per aggregare le statistiche di assegnazione dei punteggi a livello globale prima di assegnare punteggi. L'uso delle statistiche di assegnazione dei punteggi globali può aumentare la latenza delle query di ricerca.
Nome | Tipo | Descrizione |
---|---|---|
global |
string |
Le statistiche di assegnazione dei punteggi verranno calcolate a livello globale per un punteggio più coerente. |
local |
string |
Le statistiche di assegnazione dei punteggi verranno calcolate in locale per una latenza inferiore. |
SearchDocumentsResult
Risposta contenente i risultati della ricerca da un indice.
Nome | Tipo | Descrizione |
---|---|---|
@odata.count |
integer |
Numero totale di risultati rilevati dall'operazione di ricerca o Null se il conteggio non è stato richiesto. Se presente, il conteggio può essere maggiore del numero di risultati in questa risposta. Ciò può verificarsi se si usano i parametri $top o $skip oppure se la query non può restituire tutti i documenti richiesti in una singola risposta. |
@odata.nextLink |
string |
URL di continuazione restituito quando la query non può restituire tutti i risultati richiesti in una singola risposta. È possibile usare questo URL per formulare un'altra richiesta GET o POST Search per ottenere la parte successiva della risposta di ricerca. Assicurarsi di usare lo stesso verbo (GET o POST) della richiesta che ha prodotto questa risposta. |
@search.answers |
Risultati della query risposte per l'operazione di ricerca; Null se il parametro query di risposte non è stato specificato o impostato su 'nessuno'. |
|
@search.coverage |
number |
Valore che indica la percentuale dell'indice incluso nella query o null se minimumCoverage non è stato specificato nella richiesta. |
@search.facets |
object |
I risultati della query facet per l'operazione di ricerca, organizzati come raccolta di bucket per ogni campo con facet; Null se la query non includeva espressioni facet. |
@search.nextPageParameters |
Payload JSON di continuazione restituito quando la query non riesce a restituire tutti i risultati richiesti in una singola risposta. È possibile usare questo JSON insieme @odata.nextLink a per formulare un'altra richiesta POST Search per ottenere la parte successiva della risposta di ricerca. |
|
@search.semanticPartialResponseReason |
Motivo per cui è stata restituita una risposta parziale per una richiesta di classificazione semantica. |
|
@search.semanticPartialResponseType |
Tipo di risposta parziale restituita per una richiesta di classificazione semantica. |
|
value |
Sequenza di risultati restituiti dalla query. |
SearchMode
Specifica se è necessario trovare una corrispondenza con uno o tutti i termini di ricerca per includere il documento nel numero delle corrispondenze.
Nome | Tipo | Descrizione |
---|---|---|
all |
string |
Tutti i termini di ricerca devono essere corrispondenti per contare il documento come corrispondenza. |
any |
string |
Una delle condizioni di ricerca deve essere corrispondente per contare il documento come corrispondenza. |
SearchRequest
Parametri per il filtro, l'ordinamento, il facet, il paging e altri comportamenti delle query di ricerca.
Nome | Tipo | Descrizione |
---|---|---|
answers |
Valore che specifica se le risposte devono essere restituite come parte della risposta di ricerca. |
|
captions |
Valore che specifica se le didascalie devono essere restituite come parte della risposta di ricerca. |
|
count |
boolean |
Valore che specifica se recuperare il conteggio totale dei risultati. L'impostazione predefinita è false. L'impostazione di questo valore su true potrebbe avere un impatto sulle prestazioni. Si noti che il conteggio restituito è un'approssimazione. |
debug |
Abilita uno strumento di debug che può essere usato per esplorare ulteriormente i risultati rivalutati. |
|
facets |
string[] |
Elenco di espressioni facet da applicare alla query di ricerca. Ogni espressione facet contiene un nome di campo, facoltativamente seguito da un elenco delimitato da virgole di coppie name:value. |
filter |
string |
Espressione OData $filter da applicare alla query di ricerca. |
highlight |
string |
Elenco delimitato da virgole di nomi di campi da usare per le evidenziazioni di hit. Solo i campi ricercabili possono essere usati per l'evidenziazione di hit. |
highlightPostTag |
string |
Tag stringa accodato alle evidenziazioni di hit. Deve essere impostato con highlightPreTag. Il valore predefinito è </em>. |
highlightPreTag |
string |
Tag stringa prependato per l'evidenziazione. Deve essere impostato con highlightPostTag. Il valore predefinito è <em>. |
hybridSearch |
Parametri di query per configurare i comportamenti di ricerca ibrida. |
|
minimumCoverage |
number |
Numero compreso tra 0 e 100 che indica la percentuale dell'indice che deve essere coperta da una query di ricerca per poter segnalare la query come esito positivo. Questo parametro può essere utile per garantire la disponibilità di ricerca anche per i servizi con una sola replica. Il valore predefinito è 100. |
orderby |
string |
Elenco delimitato da virgole di espressioni OData $orderby in base al quale ordinare i risultati. Ogni espressione può essere un nome di campo o una chiamata alle funzioni geo.distance() o search.score(). Ogni espressione può essere seguita da asc per indicare l'crescente o il desc per indicare la decrescente. Per impostazione predefinita, l'ordinamento è crescente. Le situazioni di parità di priorità vengono risolte in base ai punteggi di corrispondenza dei documenti. Se non viene specificata alcuna $orderby, l'ordine di ordinamento predefinito è decrescente in base al punteggio di corrispondenza del documento. Possono essere presenti al massimo 32 clausole $orderby. |
queryLanguage |
Valore che specifica la lingua della query di ricerca. |
|
queryType |
Valore che specifica la sintassi della query di ricerca. Il valore predefinito è "semplice". Usare "full" se la query usa la sintassi della query Lucene. |
|
scoringParameters |
string[] |
Elenco dei valori dei parametri da usare nelle funzioni di assegnazione dei punteggi (ad esempio, referencePointParameter) usando i valori dei nomi di formato. Ad esempio, se il profilo di assegnazione dei punteggi definisce una funzione con un parametro denominato "mylocation", la stringa di parametro sarebbe "mylocation--122.2.44.8" (senza virgolette). |
scoringProfile |
string |
Nome di un profilo di punteggio da usare per la valutazione di punteggi di corrispondenza per i documenti corrispondenti, in modo da ordinare i risultati. |
scoringStatistics |
Valore che specifica se si desidera calcolare le statistiche di assegnazione dei punteggi (ad esempio la frequenza del documento) a livello globale per un punteggio più coerente o locale, per una latenza inferiore. Il valore predefinito è "local". Usare "globale" per aggregare le statistiche di assegnazione dei punteggi a livello globale prima di assegnare punteggi. L'uso delle statistiche di assegnazione dei punteggi globali può aumentare la latenza delle query di ricerca. |
|
search |
string |
Espressione di query di ricerca full-text; Usare "*" o omettere questo parametro per corrispondere a tutti i documenti. |
searchFields |
string |
Elenco delimitato da virgole di nomi di campo a cui definire l'ambito della ricerca full-text. Quando si usa la ricerca in campi (fieldName:searchExpression) in una query Lucene completa, i nomi di campo di ogni espressione di ricerca a campi hanno la precedenza su tutti i nomi di campo elencati in questo parametro. |
searchMode |
Valore che specifica se qualsiasi o tutti i termini di ricerca devono essere corrispondenti per contare il documento come corrispondenza. |
|
select |
string |
Elenco delimitato da virgole di campi da recuperare. Se non è specificato, vengono inclusi tutti i campi contrassegnati come recuperabili nello schema. |
semanticConfiguration |
string |
Nome di una configurazione semantica che verrà usata durante l'elaborazione dei documenti per le query di tipo semantica. |
semanticErrorHandling |
Consente all'utente di scegliere se una chiamata semantica deve avere esito negativo o restituire risultati parziali (impostazione predefinita). |
|
semanticFields |
string |
Elenco delimitato da virgole dei nomi di campo usati per la classificazione semantica. |
semanticMaxWaitInMilliseconds |
integer |
Consente all'utente di impostare un limite superiore per la quantità di tempo necessario per l'arricchimento semantico per completare l'elaborazione prima che la richiesta non riesca. |
semanticQuery |
string |
Consente di impostare una query di ricerca separata che verrà usata esclusivamente per la reranking semantica, le didascalie semantiche e le risposte semantiche. È utile per gli scenari in cui è necessario usare query diverse tra la fase di recupero e classificazione di base e la fase semantica L2. |
sessionId |
string |
Valore da usare per creare una sessione sticky, che può aiutare a ottenere risultati più coerenti. Purché venga usato lo stesso sessionId, verrà eseguito un tentativo di sforzo ottimale per indirizzare lo stesso set di repliche. Tenere presente che il riutilizzo degli stessi valori sessionID può interferire ripetutamente con il bilanciamento del carico delle richieste tra repliche e influire negativamente sulle prestazioni del servizio di ricerca. Il valore usato come sessionId non può iniziare con un carattere '_'. |
skip |
integer |
Numero di risultati della ricerca da ignorare. Questo valore non può essere maggiore di 100.000. Se è necessario analizzare i documenti in sequenza, ma non è possibile ignorare a causa di questa limitazione, prendere in considerazione l'uso di orderby su una chiave completamente ordinata e filtrare con una query di intervallo. |
speller |
Valore che specifica il tipo del ortografico da usare per correggere in modo ortografico i singoli termini di query di ricerca. |
|
top |
integer |
Numero di risultati della ricerca da recuperare. Questa operazione può essere usata in combinazione con $skip per implementare il paging lato client dei risultati della ricerca. Se i risultati vengono troncati a causa del paging lato server, la risposta includerà un token di continuazione che può essere usato per inviare un'altra richiesta di ricerca per la pagina successiva dei risultati. |
vectorFilterMode |
Determina se i filtri vengono applicati prima o dopo l'esecuzione della ricerca del vettore. Il valore predefinito è 'preFilter'. |
|
vectorQueries | VectorQuery[]: |
Parametri di query per query di ricerca ibrida e vettore. |
SearchResult
Contiene un documento trovato da una query di ricerca, oltre ai metadati associati.
Nome | Tipo | Descrizione |
---|---|---|
@search.captions |
Le didascalie sono i passaggi più rappresentativi del documento relativamente alla query di ricerca. Vengono spesso usati come riepilogo dei documenti. Le didascalie vengono restituite solo per le query di tipo 'semantica'. |
|
@search.documentDebugInfo |
Contiene informazioni di debug che possono essere usate per esplorare ulteriormente i risultati della ricerca. |
|
@search.highlights |
object |
Frammenti di testo dal documento che indicano i termini di ricerca corrispondenti, organizzati da ogni campo applicabile; Null se l'evidenziazione di hit non è stata abilitata per la query. |
@search.rerankerScore |
number |
Punteggio di pertinenza calcolato dal ranker semantico per i risultati principali della ricerca. I risultati della ricerca vengono ordinati in base al rerankerScore e quindi al punteggio. RerankerScore viene restituito solo per le query di tipo 'semantica'. |
@search.score |
number |
Punteggio di pertinenza del documento rispetto ad altri documenti restituiti dalla query. |
SearchScoreThreshold
I risultati della query vettoriale verranno filtrati in base al valore "@search.score". Si noti che questo è l'oggetto @search.score restituito come parte della risposta di ricerca. La direzione della soglia verrà scelta per un valore superiore @search.score.
Nome | Tipo | Descrizione |
---|---|---|
kind |
string:
search |
Tipo di soglia usato per filtrare le query vettoriali |
value |
number |
La soglia verrà filtrata in base al valore "@search.score". Si noti che questo è l'oggetto @search.score restituito come parte della risposta di ricerca. La direzione della soglia verrà scelta per un valore superiore @search.score. |
SemanticDebugInfo
Nome | Tipo | Descrizione |
---|---|---|
contentFields |
I campi di contenuto inviati al processo di arricchimento semantico, nonché il modo in cui sono stati usati |
|
keywordFields |
Campi parola chiave inviati al processo di arricchimento semantico, nonché come sono stati usati |
|
rerankerInput |
Stringhe concatenate non elaborate inviate al processo di arricchimento semantico. |
|
titleField |
Campo del titolo inviato al processo di arricchimento semantico, nonché come è stato usato |
SemanticErrorMode
Consente all'utente di scegliere se una chiamata semantica deve avere esito negativo o restituire risultati parziali (impostazione predefinita).
Nome | Tipo | Descrizione |
---|---|---|
fail |
string |
Se si verifica un'eccezione durante il passaggio di elaborazione semantica, la query avrà esito negativo e restituirà il codice HTTP appropriato a seconda dell'errore. |
partial |
string |
Se l'elaborazione semantica ha esito negativo, i risultati parziali vengono comunque restituiti. La definizione dei risultati parziali dipende dal passaggio semantico non riuscito e dal motivo dell'errore. |
SemanticErrorReason
Motivo per cui è stata restituita una risposta parziale per una richiesta di classificazione semantica.
Nome | Tipo | Descrizione |
---|---|---|
capacityOverloaded |
string |
La richiesta è stata limitata. Vengono restituiti solo i risultati di base. |
maxWaitExceeded |
string |
Se 'semanticMaxWaitInMilliseconds' è stato impostato e la durata dell'elaborazione semantica ha superato tale valore. Vengono restituiti solo i risultati di base. |
transient |
string |
Almeno un passaggio del processo semantico non è riuscito. |
SemanticFieldState
Modalità di utilizzo del campo per il processo di arricchimento semantico (completamente usato, parzialmente usato o inutilizzato)
Nome | Tipo | Descrizione |
---|---|---|
partial |
string |
Il campo è stato utilizzato parzialmente per l'arricchimento semantico. |
unused |
string |
Il campo non è stato utilizzato per l'arricchimento semantico. |
used |
string |
Il campo è stato utilizzato completamente per l'arricchimento semantico. |
SemanticSearchResultsType
Tipo di risposta parziale restituita per una richiesta di classificazione semantica.
Nome | Tipo | Descrizione |
---|---|---|
baseResults |
string |
Risultati senza arricchimento semantico o reranking. |
rerankedResults |
string |
I risultati sono stati rivalutati con il modello reranker e includono didascalie semantiche. Non includeranno risposte, risposte evidenziate o didascalia evidenziazioni. |
Speller
Migliorare il richiamo della ricerca correggendo i singoli termini di query di ricerca.
Nome | Tipo | Descrizione |
---|---|---|
lexicon |
string |
Il correttore ortografico corregge i singoli termini di query usando un lexicon statico per il linguaggio specificato dal parametro queryLanguage. |
none |
string |
Il correttore ortografico non è abilitato. |
VectorFilterMode
Determina se i filtri vengono applicati prima o dopo l'esecuzione della ricerca del vettore.
Nome | Tipo | Descrizione |
---|---|---|
postFilter |
string |
Il filtro verrà applicato dopo la restituzione del set candidato di risultati del vettore. A seconda della selettività del filtro, questo può comportare un minor numero di risultati rispetto a quello richiesto dal parametro 'k'. |
preFilter |
string |
Il filtro verrà applicato prima della query di ricerca. |
VectorizableImageBinaryQuery
Parametri di query da usare per la ricerca vettoriale quando viene fornito un file binario con codifica base 64 di un'immagine che deve essere vettorializzato.
Nome | Tipo | Descrizione |
---|---|---|
base64Image |
string |
Binario con codifica base 64 di un'immagine da vettorizzare per eseguire una query di ricerca vettoriale. |
exhaustive |
boolean |
Se true, attiva una ricerca completa k-near near neighbor in tutti i vettori all'interno dell'indice vettoriale. Utile per gli scenari in cui le corrispondenze esatte sono critiche, ad esempio per determinare i valori di verità di base. |
fields |
string |
Campi vettoriali di tipo Collection(Edm.Single) da includere nel vettore cercato. |
k |
integer |
Numero di vicini più vicini da restituire come primi riscontri. |
kind |
string:
image |
Tipo di query vettoriale da eseguire. |
oversampling |
number |
Fattore di sovracampionamento. Il valore minimo è 1. Esegue l'override del parametro 'defaultOversampling' configurato nella definizione dell'indice. Può essere impostato solo quando 'rerankWithOriginalVectors' è true. Questo parametro è consentito solo quando viene usato un metodo di compressione nel campo vettore sottostante. |
threshold | VectorThreshold: |
Soglia utilizzata per le query vettoriali. Si noti che questa impostazione può essere impostata solo se tutti i 'campi' usano la stessa metrica di somiglianza. |
weight |
number |
Peso relativo della query vettoriale rispetto ad altre query vettoriali e/o alla query di testo all'interno della stessa richiesta di ricerca. Questo valore viene usato quando si combinano i risultati di più elenchi di classificazione prodotti dalle diverse query vettoriali e/o i risultati recuperati tramite la query di testo. Maggiore sarà il peso, maggiore sarà il numero di documenti corrispondenti alla query nella classificazione finale. Il valore predefinito è 1,0 e il valore deve essere un numero positivo maggiore di zero. |
VectorizableImageUrlQuery
I parametri di query da usare per la ricerca vettoriale quando viene fornito un URL che rappresenta un valore di immagine che deve essere vettorializzato.
Nome | Tipo | Descrizione |
---|---|---|
exhaustive |
boolean |
Se true, attiva una ricerca più vicina e completa tra tutti i vettori all'interno dell'indice vettore. Utile per gli scenari in cui le corrispondenze esatte sono critiche, ad esempio determinare i valori di verità di terra. |
fields |
string |
Campi vettoriali di tipo Collection(Edm.Single) da includere nel vettore cercato. |
k |
integer |
Numero di vicini più vicini da restituire come risultati principali. |
kind |
string:
image |
Tipo di query vettoriale eseguita. |
oversampling |
number |
Fattore di sovrasampling. Il valore minimo è 1. Esegue l'override del parametro 'defaultOversampling' configurato nella definizione dell'indice. Può essere impostato solo quando 'rerankWithOriginalVectors' è true. Questo parametro è consentito solo quando viene usato un metodo di compressione nel campo vettore sottostante. |
threshold | VectorThreshold: |
Soglia utilizzata per le query vettoriali. Si noti che questa impostazione può essere impostata solo se tutti i 'campi' usano la stessa metrica di somiglianza. |
url |
string |
URL di un'immagine da vettorizzare per eseguire una query di ricerca vettoriale. |
weight |
number |
Peso relativo della query vettore rispetto ad altre query vettoriali e/o alla query di testo all'interno della stessa richiesta di ricerca. Questo valore viene usato quando si combinano i risultati di più elenchi di classificazione generati dalle diverse query vettoriali e/o i risultati recuperati tramite la query di testo. Maggiore sarà il peso, maggiore sarà il numero di documenti corrispondenti alla query nella classificazione finale. Il valore predefinito è 1,0 e il valore deve essere un numero positivo maggiore di zero. |
VectorizableTextQuery
I parametri di query da usare per la ricerca vettoriale quando viene fornito un valore di testo che deve essere vettorializzato.
Nome | Tipo | Descrizione |
---|---|---|
exhaustive |
boolean |
Se true, attiva una ricerca più vicina e completa tra tutti i vettori all'interno dell'indice vettore. Utile per gli scenari in cui le corrispondenze esatte sono critiche, ad esempio determinare i valori di verità di terra. |
fields |
string |
Campi vettoriali di tipo Collection(Edm.Single) da includere nel vettore cercato. |
k |
integer |
Numero di vicini più vicini da restituire come risultati principali. |
kind |
string:
text |
Tipo di query vettoriale eseguita. |
oversampling |
number |
Fattore di sovrasampling. Il valore minimo è 1. Esegue l'override del parametro 'defaultOversampling' configurato nella definizione dell'indice. Può essere impostato solo quando 'rerankWithOriginalVectors' è true. Questo parametro è consentito solo quando viene usato un metodo di compressione nel campo vettore sottostante. |
text |
string |
Testo da vettorizzare per eseguire una query di ricerca vettoriale. |
threshold | VectorThreshold: |
Soglia usata per le query vettoriali. Nota che può essere impostato solo se tutti i 'campi' usano la stessa metrica di somiglianza. |
weight |
number |
Peso relativo della query vettore rispetto ad altre query vettoriali e/o alla query di testo all'interno della stessa richiesta di ricerca. Questo valore viene usato quando si combinano i risultati di più elenchi di classificazione generati dalle diverse query vettoriali e/o i risultati recuperati tramite la query di testo. Maggiore è il peso, più alto saranno i documenti corrispondenti alla query nella classifica finale. Il valore predefinito è 1,0 e il valore deve essere un numero positivo maggiore di zero. |
VectorQueryKind
Tipo di query vettoriale da eseguire.
Nome | Tipo | Descrizione |
---|---|---|
imageBinary |
string |
Query vettoriale in cui viene fornito un file binario con codifica Base 64 di un'immagine che deve essere vettorializzato. |
imageUrl |
string |
Query vettoriale in cui viene fornito un URL che rappresenta un valore di immagine che deve essere vettorializzato. |
text |
string |
Query vettoriale in cui viene fornito un valore di testo che deve essere vettorializzato. |
vector |
string |
Query vettoriale in cui viene fornito un valore di vettore non elaborato. |
VectorSimilarityThreshold
I risultati della query vettoriale verranno filtrati in base alla metrica di somiglianza del vettore. Si noti che si tratta della definizione canonica della metrica di somiglianza, non della versione "distance". La direzione della soglia (maggiore o minore) verrà scelta automaticamente in base alla metrica usata dal campo.
Nome | Tipo | Descrizione |
---|---|---|
kind |
string:
vector |
Tipo di soglia usato per filtrare le query vettoriali |
value |
number |
La soglia verrà filtrata in base al valore della metrica di somiglianza. Si noti che si tratta della definizione canonica della metrica di somiglianza, non della versione "distance". La direzione della soglia (maggiore o minore) verrà scelta automaticamente in base alla metrica usata dal campo. |
VectorThresholdKind
Tipo di query vettoriale da eseguire.
Nome | Tipo | Descrizione |
---|---|---|
searchScore |
string |
I risultati della query vettoriale verranno filtrati in base al valore "@search.score". Si noti che questo è l'oggetto @search.score restituito come parte della risposta di ricerca. La direzione della soglia verrà scelta per un valore superiore @search.score. |
vectorSimilarity |
string |
I risultati della query vettoriale verranno filtrati in base alla metrica di somiglianza del vettore. Si noti che si tratta della definizione canonica della metrica di somiglianza, non della versione "distance". La direzione della soglia (maggiore o minore) verrà scelta automaticamente in base alla metrica usata dal campo. |