Documents - Search Post

Servizio:

Search Service

Versione API:

2025-11-01-preview

Cerca i documenti nell'indice.

POST https:///indexes('{indexName}')/docs/search.post.search?api-version=2025-11-01-preview

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
indexName	path	True	string	Nome dell'indice.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
Accept	True	Accept	L'intestazione Accetta.
x-ms-query-source-authorization		string	Token che identifica l'utente per il quale viene eseguita la query. Questo token viene utilizzato per applicare restrizioni di sicurezza ai documenti.
x-ms-enable-elevated-read		boolean	Valore che abilita la lettura con privilegi elevati che ignora i controlli delle autorizzazioni a livello di documento per l'operazione di query.
x-ms-client-request-id		string (uuid)	Identificatore di stringa opaco, univoco a livello globale e generato dal client per la richiesta.

Corpo della richiesta

Nome	Tipo	Descrizione
answers	QueryAnswerType	Valore che specifica se le risposte devono essere restituite come parte della risposta di ricerca.
captions	QueryCaptionType	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. Il valore predefinito è false. L'impostazione di questo valore su true può avere un impatto sulle prestazioni. Si noti che il conteggio restituito è un'approssimazione.
debug	QueryDebugMode	Abilita uno strumento di debug che può essere utilizzato per esplorare ulteriormente i risultati riclassificati.
facets	string[]	Elenco di espressioni di facet da applicare alla query di ricerca. Ogni espressione di facet contiene un nome di campo, seguito facoltativamente da un elenco delimitato da virgole di coppie nome:valore.
filter	string	OData $filter un'espressione da applicare alla query di ricerca.
highlight	string	L'elenco delimitato da virgole dei nomi dei campi da utilizzare per le evidenziazioni dei risultati. Per l'evidenziazione dei risultati è possibile utilizzare solo i campi in cui è possibile effettuare la ricerca.
highlightPostTag	string	Un tag stringa che viene aggiunto per colpire le evidenziazioni. Deve essere impostato con highlightPreTag. Il valore predefinito è </em>.
highlightPreTag	string	Un tag stringa anteposto per colpire le evidenziazioni. Deve essere impostato con highlightPostTag. Il valore predefinito è <em>.
hybridSearch	HybridSearch	Parametri di query per configurare i comportamenti di ricerca ibrida.
minimumCoverage	number (double)	Un 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.
orderby	string	L'elenco delimitato da virgole di OData $orderby espressioni in base alle quali 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'ascendente o desc per indicare l'ascendente. Il valore predefinito è l'ordine crescente. I pareggi saranno risolti dai punteggi dei documenti. Se non viene specificata alcuna $orderby, l'ordinamento predefinito è decrescente in base al punteggio di corrispondenza del documento. Ci possono essere al massimo 32 $orderby clausole.
queryLanguage	QueryLanguage	Valore che specifica la lingua della query di ricerca.
queryRewrites	QueryRewritesType	Valore che specifica se è necessario generare riscritture delle query per aumentare la query di ricerca.
queryType	QueryType	Valore che specifica la sintassi della query di ricerca. Il valore predefinito è 'simple'. Utilizzare 'full' se la query utilizza la sintassi della query Lucene.
scoringParameters	string[]	Elenco dei valori dei parametri da utilizzare nelle funzioni di assegnazione dei punteggi (ad esempio, referencePointParameter) utilizzando il formato nome-valori. Ad esempio, se il profilo di punteggio definisce una funzione con un parametro denominato 'mylocation', la stringa del parametro sarà "mylocation--122.2,44.8" (senza virgolette).
scoringProfile	string	Il nome di un profilo di punteggio per valutare i punteggi delle corrispondenze per i documenti corrispondenti al fine di ordinare i risultati.
scoringStatistics	ScoringStatistics	Un valore che specifica se si desidera calcolare le statistiche di punteggio (ad esempio la frequenza dei documenti) a livello globale per un punteggio più coerente o a livello locale, per una latenza inferiore. Il valore predefinito è 'locale'. Utilizza "globale" per aggregare le statistiche di punteggio a livello globale prima di segnare. L'uso delle statistiche di punteggio globali può aumentare la latenza delle query di ricerca.
search	string	Un'espressione di query di ricerca full-text; Utilizzare "*" o omettere questo parametro per la corrispondenza di tutti i documenti.
searchFields	string	Elenco delimitato da virgole di nomi di campo in cui definire l'ambito della ricerca full-text. Quando si utilizza la ricerca sul campo (fieldName:searchExpression) in una query Lucene completa, i nomi dei campi di ogni espressione di ricerca sui campi hanno la precedenza su tutti i nomi dei campi elencati in questo parametro.
searchMode	SearchMode	Valore che specifica se è necessario trovare una corrispondenza tra uno o tutti i termini di ricerca per poter conteggiare il documento come corrispondenza.
select	string	L'elenco delimitato da virgole dei 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à utilizzata durante l'elaborazione di documenti per query di tipo semantico.
semanticErrorHandling	SemanticErrorMode	Consente all'utente di scegliere se una chiamata semantica deve avere esito negativo completo (comportamento predefinito/corrente) o se deve restituire risultati parziali.
semanticFields	string	Elenco delimitato da virgole dei nomi dei campi utilizzati per la classificazione semantica.
semanticMaxWaitInMilliseconds	integer (int32) minimum: 700	Consente all'utente di impostare un limite superiore per la quantità di tempo necessaria per il completamento dell'elaborazione dell'arricchimento semantico prima che la richiesta abbia esito negativo.
semanticQuery	string	Consente di impostare una query di ricerca separata che verrà utilizzata esclusivamente per il riposizionamento semantico, le didascalie semantiche e le risposte semantiche. È utile per gli scenari in cui è necessario utilizzare query diverse tra la fase di recupero e classificazione della base e la fase semantica L2.
sessionId	string	Un valore da utilizzare per creare una sessione permanente, che può aiutare a ottenere risultati più coerenti. Finché viene utilizzato lo stesso sessionId, verrà effettuato un tentativo ottimale per indirizzare lo stesso set di repliche. Tenere presente che il riutilizzo ripetuto degli stessi valori sessionID può interferire con il bilanciamento del carico delle richieste tra le repliche e influire negativamente sulle prestazioni del servizio di ricerca. Il valore utilizzato come sessionId non può iniziare con un carattere '_'.
skip	integer (int32)	Il 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 utilizzare skip a causa di questa limitazione, è consigliabile utilizzare orderby su una chiave ordinata completamente e filtrare con una query di intervallo.
speller	QuerySpellerType	Un valore che specifica il tipo di ortografia da usare per correggere singoli termini di ricerca di ricerca.
top	integer (int32)	Il numero di risultati della ricerca da recuperare. Questo può essere utilizzato insieme a $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 utilizzato per inviare un'altra richiesta di ricerca per la pagina successiva dei risultati.
vectorFilterMode	VectorFilterMode	Determina se i filtri vengono applicati prima o dopo l'esecuzione della ricerca vettoriale. Il valore predefinito è 'preFilter' per i nuovi indici.
vectorQueries	VectorQuery[]: VectorizableImageBinaryQuery[] VectorizableImageUrlQuery[] VectorizableTextQuery[] VectorizedQuery[]	Parametri di query per le query di ricerca ibrida e vettoriali.

Risposte

Nome	Tipo	Descrizione
200 OK	SearchDocumentsResult	La richiesta ha avuto esito positivo.
Other Status Codes	SearchDocumentsResult	Operazione completata
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Sicurezza

api-key

Tipo: apiKey
In: header

OAuth2Auth

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Ambiti

Nome	Descrizione
https://search.azure.com/.default

Esempio

SearchIndexSearchDocumentsPost

SearchIndexSearchDocumentsSemanticPost

SearchIndexSearchDocumentsPost

Esempio di richiesta

HTTP

POST https:///indexes('preview-test')/docs/search.post.search?api-version=2025-11-01-preview




{
  "count": true,
  "facets": [
    "ownerId",
    "price,metric:sum,default:10"
  ],
  "filter": "category eq 'purple' or category eq 'pink'",
  "highlight": "category",
  "highlightPostTag": "</em>",
  "highlightPreTag": "</em>",
  "minimumCoverage": 100,
  "queryType": "semantic",
  "scoringStatistics": "global",
  "sessionId": "mysessionid",
  "scoringParameters": [
    "categoryTag:desiredCategoryValue"
  ],
  "scoringProfile": "stringFieldBoost",
  "debug": "vector",
  "search": "purple",
  "searchFields": "id,name,description,category,ownerId",
  "searchMode": "any",
  "queryLanguage": "en-us",
  "speller": "lexicon",
  "select": "id,name,description,category,ownerId",
  "skip": 0,
  "top": 10,
  "semanticConfiguration": "testconfig",
  "semanticErrorHandling": "partial",
  "semanticMaxWaitInMilliseconds": 5000,
  "semanticQuery": "find all purple",
  "answers": "extractive",
  "captions": "extractive",
  "queryRewrites": "generative",
  "vectorQueries": [
    {
      "vector": [
        0,
        1,
        2,
        3,
        4,
        5,
        6,
        7,
        8,
        9
      ],
      "kind": "vector",
      "k": 50,
      "fields": "vector22, vector1b",
      "oversampling": 20,
      "weight": 1,
      "threshold": {
        "value": 0.984,
        "kind": "vectorSimilarity"
      },
      "filterOverride": "ownerId eq 'sam'"
    }
  ],
  "vectorFilterMode": "preFilter",
  "hybridSearch": {
    "maxTextRecallSize": 100,
    "countAndFacetMode": "countAllResults"
  }
}

Risposta di esempio

Codice di stato:

200

{
  "@odata.count": 27,
  "@search.coverage": 100,
  "@search.facets": {
    "ownerId": [
      {
        "count": 16,
        "value": "sam"
      },
      {
        "count": 8,
        "value": "ryan"
      },
      {
        "count": 3,
        "value": "benny"
      }
    ],
    "price": [
      {
        "sum": 320
      }
    ]
  },
  "@search.answers": [],
  "value": [
    {
      "@search.score": 0.015625,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.7178425788879395,
      "@search.rerankerBoostedScore": 1.7178425788879395,
      "@search.captions": [
        {
          "text": "test10 hello.",
          "highlights": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 27.725889205932617
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "id": "10",
      "name": "test",
      "description": "test10 hello",
      "category": "purple",
      "ownerId": "benny"
    },
    {
      "@search.score": 0.012820512987673283,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.7079174518585205,
      "@search.rerankerBoostedScore": 1.7079174518585205,
      "@search.captions": [
        {
          "text": "no vector.",
          "highlights": "</em>no vector.</em>"
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 21.559860229492188
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "id": "empty-vectors",
      "name": "test",
      "description": "no vector",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 0.011627906933426857,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.7079174518585205,
      "@search.rerankerBoostedScore": 1.7079174518585205,
      "@search.captions": [
        {
          "text": "no vector.",
          "highlights": "</em>no vector.</em>"
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 6.500757217407227
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "id": "no-vectors",
      "name": "test",
      "description": "no vector",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 0.011904762126505375,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.6994102001190186,
      "@search.rerankerBoostedScore": 1.6994102001190186,
      "@search.captions": [
        {
          "text": "test4 hello.",
          "highlights": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 6.500757217407227
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "id": "4",
      "name": "test",
      "description": "test4 hello",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 0.012345679104328156,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.6937386989593506,
      "@search.rerankerBoostedScore": 1.6937386989593506,
      "@search.captions": [
        {
          "text": "test2 hello.",
          "highlights": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 6.500757217407227
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "id": "2",
      "name": "test",
      "description": "test2 hello",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 0.0117647061124444,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.6923208236694336,
      "@search.rerankerBoostedScore": 1.6923208236694336,
      "@search.captions": [
        {
          "text": "test5 hello.",
          "highlights": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 6.500757217407227
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "id": "5",
      "name": "test",
      "description": "test5 hello",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 0.01666666753590107,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.691611886024475,
      "@search.rerankerBoostedScore": 1.691611886024475,
      "@search.captions": [
        {
          "text": "test7 hello.",
          "highlights": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 39.23316955566406
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "id": "7",
      "name": "test",
      "description": "test7 hello",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 0.013698630034923553,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.6781420707702637,
      "@search.rerankerBoostedScore": 1.6781420707702637,
      "@search.captions": [
        {
          "text": "test0 hello.",
          "highlights": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 21.559860229492188
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "id": "0",
      "name": "test",
      "description": "test0 hello",
      "category": "purple",
      "ownerId": "benny"
    },
    {
      "@search.score": 0.013888888992369175,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.6653810739517212,
      "@search.rerankerBoostedScore": 1.6653810739517212,
      "@search.captions": [
        {
          "text": "test8 hello.",
          "highlights": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 23.01456642150879
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "id": "8",
      "name": "test",
      "description": "test8 hello",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 0.012658228166401386,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.6618363857269287,
      "@search.rerankerBoostedScore": 1.6618363857269287,
      "@search.captions": [
        {
          "text": "test11 hello.",
          "highlights": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 6.500757217407227
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "id": "11",
      "name": "test",
      "description": "test11 hello",
      "category": "purple",
      "ownerId": "sam"
    }
  ]
}

Codice di stato:

206

{
  "@odata.count": 27,
  "@search.coverage": 100,
  "@search.facets": {
    "ownerId": [
      {
        "count": 16,
        "value": "sam"
      },
      {
        "count": 8,
        "value": "ryan"
      },
      {
        "count": 3,
        "value": "benny"
      }
    ],
    "price": [
      {
        "sum": 320
      }
    ]
  },
  "@search.answers": [],
  "value": [
    {
      "@search.score": 0.015625,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.7178425788879395,
      "@search.rerankerBoostedScore": 1.7178425788879395,
      "@search.captions": [
        {
          "text": "test10 hello.",
          "highlights": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 27.725889205932617
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "id": "10",
      "name": "test",
      "description": "test10 hello",
      "category": "purple",
      "ownerId": "benny"
    },
    {
      "@search.score": 0.012820512987673283,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.7079174518585205,
      "@search.rerankerBoostedScore": 1.7079174518585205,
      "@search.captions": [
        {
          "text": "no vector.",
          "highlights": "</em>no vector.</em>"
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 21.559860229492188
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "id": "empty-vectors",
      "name": "test",
      "description": "no vector",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 0.011627906933426857,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.7079174518585205,
      "@search.rerankerBoostedScore": 1.7079174518585205,
      "@search.captions": [
        {
          "text": "no vector.",
          "highlights": "</em>no vector.</em>"
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 6.500757217407227
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "id": "no-vectors",
      "name": "test",
      "description": "no vector",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 0.011904762126505375,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.6994102001190186,
      "@search.rerankerBoostedScore": 1.6994102001190186,
      "@search.captions": [
        {
          "text": "test4 hello.",
          "highlights": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 6.500757217407227
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "id": "4",
      "name": "test",
      "description": "test4 hello",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 0.012345679104328156,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.6937386989593506,
      "@search.rerankerBoostedScore": 1.6937386989593506,
      "@search.captions": [
        {
          "text": "test2 hello.",
          "highlights": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 6.500757217407227
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "id": "2",
      "name": "test",
      "description": "test2 hello",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 0.0117647061124444,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.6923208236694336,
      "@search.rerankerBoostedScore": 1.6923208236694336,
      "@search.captions": [
        {
          "text": "test5 hello.",
          "highlights": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 6.500757217407227
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "id": "5",
      "name": "test",
      "description": "test5 hello",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 0.01666666753590107,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.691611886024475,
      "@search.rerankerBoostedScore": 1.691611886024475,
      "@search.captions": [
        {
          "text": "test7 hello.",
          "highlights": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 39.23316955566406
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "id": "7",
      "name": "test",
      "description": "test7 hello",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 0.013698630034923553,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.6781420707702637,
      "@search.rerankerBoostedScore": 1.6781420707702637,
      "@search.captions": [
        {
          "text": "test0 hello.",
          "highlights": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 21.559860229492188
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "id": "0",
      "name": "test",
      "description": "test0 hello",
      "category": "purple",
      "ownerId": "benny"
    },
    {
      "@search.score": 0.013888888992369175,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.6653810739517212,
      "@search.rerankerBoostedScore": 1.6653810739517212,
      "@search.captions": [
        {
          "text": "test8 hello.",
          "highlights": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 23.01456642150879
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "id": "8",
      "name": "test",
      "description": "test8 hello",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 0.012658228166401386,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "@search.rerankerScore": 1.6618363857269287,
      "@search.rerankerBoostedScore": 1.6618363857269287,
      "@search.captions": [
        {
          "text": "test11 hello.",
          "highlights": ""
        }
      ],
      "@search.documentDebugInfo": {
        "vectors": {
          "subscores": {
            "documentBoost": 1,
            "text": {
              "searchScore": 6.500757217407227
            },
            "vectors": [
              {}
            ]
          }
        }
      },
      "id": "11",
      "name": "test",
      "description": "test11 hello",
      "category": "purple",
      "ownerId": "sam"
    }
  ]
}

SearchIndexSearchDocumentsSemanticPost

Esempio di richiesta

HTTP

POST https:///indexes('myindex')/docs/search.post.search?api-version=2025-11-01-preview

{
  "count": true,
  "highlightPostTag": "</em>",
  "highlightPreTag": "<em>",
  "queryType": "semantic",
  "search": "how do clouds form",
  "semanticConfiguration": "my-semantic-config",
  "answers": "extractive|count-3",
  "captions": "extractive|highlight-true",
  "semanticErrorHandling": "partial",
  "semanticMaxWaitInMilliseconds": 780
}

Risposta di esempio

Codice di stato:

200

{
  "@odata.count": 25,
  "@search.answers": [
    {
      "key": "4123",
      "text": "Sunlight heats the land all day, warming that moist air and causing it to rise high into the   atmosphere until it cools and condenses into water droplets. Clouds generally form where air is ascending (over land in this case),   but not where it is descending (over the river).",
      "highlights": "Sunlight heats the land all day, warming that moist air and causing it to rise high into the   atmosphere until it cools and condenses into water droplets. Clouds generally form<em> where air is ascending</em> (over land in this case),   but not where it is<em> descending</em> (over the river).",
      "score": 0.94639826
    }
  ],
  "@search.nextPageParameters": {
    "count": true,
    "highlightPostTag": "</em>",
    "highlightPreTag": "<em>",
    "queryType": "semantic",
    "search": "how do clouds form",
    "semanticConfiguration": "my-semantic-config",
    "answers": "extractive|count-3",
    "captions": "extractive|highlight-true",
    "semanticErrorHandling": "partial",
    "semanticMaxWaitInMilliseconds": 780,
    "skip": 2,
    "top": 8
  },
  "value": [
    {
      "@search.score": 0.5479723,
      "@search.rerankerScore": 1.0321671911515296,
      "@search.captions": [
        {
          "text": "Like all clouds, it forms when the air reaches its dew point—the temperature at which an air mass is cool enough for its water vapor to condense into liquid droplets. This false-color image shows valley fog, which is common in the Pacific Northwest of North America.",
          "highlights": "Like all<em> clouds</em>, it<em> forms</em> when the air reaches its dew point—the temperature at    which an air mass is cool enough for its water vapor to condense into liquid droplets. This false-color image shows valley<em> fog</em>, which is common in the Pacific Northwest of North America."
        }
      ],
      "id": "4123",
      "title": "Earth Atmosphere",
      "content": "Fog is essentially a cloud lying on the ground. Like all clouds, it forms when the air reaches its dew point—the temperature at  \n\nwhich an air mass is cool enough for its water vapor to condense into liquid droplets.\n\nThis false-color image shows valley fog, which is common in the Pacific Northwest of North America. On clear winter nights, the \n\nground and overlying air cool off rapidly, especially at high elevations. Cold air is denser than warm air, and it sinks down into the \n\nvalleys. The moist air in the valleys gets chilled to its dew point, and fog forms. If undisturbed by winds, such fog may persist for \n\ndays. The Terra satellite captured this image of foggy valleys northeast of Vancouver in February 2010.\n\n\n",
      "locations": [
        "Pacific Northwest",
        "North America",
        "Vancouver"
      ]
    }
  ],
  "@odata.nextLink": "https://myservice.search.windows.net/indexes('myindex')/docs/search.post.search?api-version=2025-05-01-preview"
}

Codice di stato:

206

{
  "@odata.count": 25,
  "@search.answers": [
    {
      "key": "4123",
      "text": "Sunlight heats the land all day, warming that moist air and causing it to rise high into the   atmosphere until it cools and condenses into water droplets. Clouds generally form where air is ascending (over land in this case),   but not where it is descending (over the river).",
      "highlights": "Sunlight heats the land all day, warming that moist air and causing it to rise high into the   atmosphere until it cools and condenses into water droplets. Clouds generally form<em> where air is ascending</em> (over land in this case),   but not where it is<em> descending</em> (over the river).",
      "score": 0.94639826
    }
  ],
  "@search.nextPageParameters": {
    "count": true,
    "highlightPostTag": "</em>",
    "highlightPreTag": "<em>",
    "queryType": "semantic",
    "search": "how do clouds form",
    "semanticConfiguration": "my-semantic-config",
    "answers": "extractive|count-3",
    "captions": "extractive|highlight-true",
    "semanticErrorHandling": "partial",
    "semanticMaxWaitInMilliseconds": 780,
    "skip": 2,
    "top": 8
  },
  "value": [
    {
      "@search.score": 0.5479723,
      "@search.rerankerScore": 1.0321671911515296,
      "@search.captions": [
        {
          "text": "Like all clouds, it forms when the air reaches its dew point—the temperature at which an air mass is cool enough for its water vapor to condense into liquid droplets. This false-color image shows valley fog, which is common in the Pacific Northwest of North America.",
          "highlights": "Like all<em> clouds</em>, it<em> forms</em> when the air reaches its dew point—the temperature at    which an air mass is cool enough for its water vapor to condense into liquid droplets. This false-color image shows valley<em> fog</em>, which is common in the Pacific Northwest of North America."
        }
      ],
      "id": "4123",
      "title": "Earth Atmosphere",
      "content": "Fog is essentially a cloud lying on the ground. Like all clouds, it forms when the air reaches its dew point—the temperature at  \n\nwhich an air mass is cool enough for its water vapor to condense into liquid droplets.\n\nThis false-color image shows valley fog, which is common in the Pacific Northwest of North America. On clear winter nights, the \n\nground and overlying air cool off rapidly, especially at high elevations. Cold air is denser than warm air, and it sinks down into the \n\nvalleys. The moist air in the valleys gets chilled to its dew point, and fog forms. If undisturbed by winds, such fog may persist for \n\ndays. The Terra satellite captured this image of foggy valleys northeast of Vancouver in February 2010.\n\n\n",
      "locations": [
        "Pacific Northwest",
        "North America",
        "Vancouver"
      ]
    }
  ],
  "@odata.nextLink": "https://myservice.search.windows.net/indexes('myindex')/docs/search.post.search?api-version=2025-05-01-preview"
}

Definizioni

Nome	Descrizione
Accept	L'intestazione Accetta.
DebugInfo	Contiene informazioni di debug che possono essere usate per esplorare ulteriormente i risultati della ricerca.
DocumentDebugInfo	Contiene informazioni di debug che possono essere usate per esplorare ulteriormente i risultati della ricerca.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore comune per tutte le API di Azure Resource Manager per restituire i dettagli dell'errore per le operazioni non riuscite. Questo segue anche il formato di risposta di errore OData.
HybridCountAndFacetMode	Determina se il conteggio e i facet devono includere tutti i documenti che corrispondono alla query di ricerca o solo i documenti recuperati all'interno della finestra 'maxTextRecallSize'. Il valore predefinito è 'countAllResults'.
HybridSearch	Parametri di query per configurare i comportamenti della ricerca ibrida.
QueryAnswerResult	Una risposta è un passaggio di testo estratto dal contenuto dei documenti più rilevanti che corrispondono alla query. Le risposte vengono estratte dai primi risultati della ricerca. I candidati alle risposte vengono assegnati punteggi e vengono selezionate le risposte principali.
QueryAnswerType	Questo parametro è valido solo se il tipo di query è semantic. Se impostata, la query restituisce le risposte estratte dai passaggi chiave nei documenti con il punteggio più alto. Il numero di risposte restituite può essere configurato aggiungendo il carattere | pipe seguito dall'opzione count-<number of answers> dopo il valore del parametro answers, ad esempio extractive|count-3. Il conteggio predefinito è 1. La soglia di confidenza può essere configurata aggiungendo il carattere | pipe seguito dall'opzione threshold-<confidence threshold> dopo il valore del parametro answers, ad esempio extractive|threshold-0.9. La soglia predefinita è 0,7. La lunghezza massima dei caratteri delle risposte può essere configurata aggiungendo il carattere pipe '|' seguito dal 'numero di conteggio< della lunghezza> massima dei caratteri', ad esempio 'extractive|maxcharlength-600'.
QueryCaptionResult	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.
QueryCaptionType	Questo parametro è valido solo se il tipo di query è semantic. Se impostata, la query restituisce le didascalie estratte dai passaggi chiave nei documenti classificati più alti. Quando Didascalie è impostato su extractive, l'evidenziazione è abilitata per impostazione predefinita e può essere configurata aggiungendo il carattere | pipe seguito dall'opzione highlight-<true/false> , ad esempio extractive|highlight-true. Il valore predefinito è None. La lunghezza massima dei caratteri delle didascalie può essere configurata aggiungendo il carattere pipe '|' seguito dal 'numero di conteggio< della lunghezza> massima dei caratteri', ad esempio 'extractive|maxcharlength-600'.
QueryDebugMode	Abilita uno strumento di debug che può essere utilizzato per esplorare ulteriormente i risultati della ricerca. È possibile abilitare più modalità di debug contemporaneamente separandole con un | carattere, ad esempio: semantic|queryRewrites.
QueryLanguage	Lingua della query.
QueryResultDocumentRerankerInput	Stringhe concatenate non elaborate inviate al processo di arricchimento semantico.
QueryResultDocumentSemanticField	Descrizione dei campi inviati al processo di arricchimento semantico, nonché del modo in cui sono stati usati
QueryResultDocumentSubscores	Suddivisione dei caratteri di sottolineatura tra i componenti di query di testo e vettore della query di ricerca per questo documento. Ogni query vettoriale viene visualizzata come oggetto separato nello stesso ordine in cui sono stati ricevuti.
QueryRewritesDebugInfo	Contiene informazioni di debug specifiche per la riscrittura delle query.
QueryRewritesType	Questo parametro è valido solo se il tipo di query è semantic. Quando QueryRewrites è impostato su generative, i termini della query vengono inviati a un modello di generazione che produrrà 10 riscritture (impostazione predefinita) per aumentare il richiamo della richiesta. Il conteggio richiesto può essere configurato aggiungendo il carattere | pipe seguito dall'opzione count-<number of rewrites> , ad esempio generative|count-3. Il valore predefinito è None.
QueryRewritesValuesDebugInfo	Contiene informazioni di debug specifiche per la riscrittura delle query.
QuerySpellerType	Migliorare il richiamo della ricerca correggendo i singoli termini di query di ricerca.
QueryType	Specifica la sintassi della query di ricerca. Il valore predefinito è 'simple'. Utilizzare 'full' se la query utilizza la sintassi della query Lucene e 'semantic' se la sintassi della query non è necessaria.
ScoringStatistics	Un valore che specifica se si desidera calcolare le statistiche di punteggio (ad esempio la frequenza dei documenti) a livello globale per un punteggio più coerente o a livello locale, per una latenza inferiore. Il valore predefinito è 'locale'. Utilizza "globale" per aggregare le statistiche di punteggio a livello globale prima di segnare. L'uso delle statistiche di punteggio globali può aumentare la latenza delle query di ricerca.
SearchDocumentsResult	Risposta contenente i risultati della ricerca da un indice.
SearchMode	Specifica se è necessario trovare una corrispondenza tra uno o tutti i termini di ricerca per poter conteggiare il documento come corrispondenza.
SearchRequest	Parametri per il filtro, l'ordinamento, il facet, il paging e altri comportamenti delle query di ricerca.
SearchResult	Contiene un documento trovato da una query di ricerca, oltre ai metadati associati.
SearchScoreThreshold	I risultati della query vettoriale filtreranno in base al '
SemanticDebugInfo	Contiene informazioni di debug specifiche per le richieste di classificazione semantica.
SemanticErrorMode	Permette all'utente di scegliere se una chiamata semantica fallisca completamente o di restituire risultati parziali.
SemanticErrorReason	Motivo per cui è stata restituita una risposta parziale per una richiesta di classificazione semantica.
SemanticFieldState	Il modo in cui il campo veniva utilizzato per il processo di arricchimento semantico.
SemanticQueryRewritesResultType	Tipo di riscrittura della query utilizzata per questa richiesta.
SemanticSearchResultsType	Tipo di risposta parziale restituita per una richiesta di classificazione semantica.
SingleVectorFieldResult	Risultato di un singolo campo vettoriale. Entrambi
TextResult	Punteggio BM25 o Classico per la parte di testo della query.
VectorFilterMode	Determina se i filtri vengono applicati prima o dopo l'esecuzione della ricerca vettoriale.
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 vettorializzata.
VectorizableImageUrlQuery	Parametri di query da usare per la ricerca vettoriale quando viene fornito un URL che rappresenta un valore di immagine che deve essere vettorializzato.
VectorizableTextQuery	Parametri di query da usare per la ricerca vettoriale quando viene fornito un valore di testo che deve essere vettorializzato.
VectorizedQuery	Parametri di query da usare per la ricerca vettoriale quando viene specificato un valore di vettore non elaborato.
VectorQueryKind	Tipo di query vettoriale eseguita.
VectorsDebugInfo	"Contiene informazioni di debug specifiche per la ricerca vettoriale e ibrida.")
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.
VectorThresholdKind	Il tipo di soglia usata per filtrare le query vettoriali.

Accept

Enumerazione

L'intestazione Accetta.

Valore	Descrizione
application/json;odata.metadata=none

DebugInfo

Oggetto

Contiene informazioni di debug che possono essere usate per esplorare ulteriormente i risultati della ricerca.

Nome	Tipo	Descrizione
queryRewrites	QueryRewritesDebugInfo	Contiene informazioni di debug specifiche per la riscrittura delle query.

DocumentDebugInfo

Oggetto

Contiene informazioni di debug che possono essere usate per esplorare ulteriormente i risultati della ricerca.

Nome	Tipo	Descrizione
innerHits	object	Contiene informazioni di debug specifiche per i vettori corrispondenti all'interno di un insieme di tipi complessi.
semantic	SemanticDebugInfo	Contiene informazioni di debug specifiche per le richieste di classificazione semantica.
vectors	VectorsDebugInfo	Contiene informazioni di debug specifiche per la ricerca ibrida e vettoriale.

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info		Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore comune per tutte le API di Azure Resource Manager per restituire i dettagli dell'errore per le operazioni non riuscite. Questo segue anche il formato di risposta di errore OData.

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

HybridCountAndFacetMode

Enumerazione

Determina se il conteggio e i facet devono includere tutti i documenti che corrispondono alla query di ricerca o solo i documenti recuperati all'interno della finestra 'maxTextRecallSize'. Il valore predefinito è 'countAllResults'.

Valore	Descrizione
countRetrievableResults	Includi solo i documenti che sono stati trovati all'interno della finestra di recupero 'maxTextRecallSize' durante il calcolo di 'count' e 'facets'.
countAllResults	Includi tutti i documenti che sono stati trovati per la corrispondenza con la query di ricerca durante il calcolo di "count" e "facets", indipendentemente dal fatto che tali documenti si trovino o meno all'interno della finestra di recupero "maxTextRecallSize".

HybridSearch

Oggetto

Parametri di query per configurare i comportamenti della ricerca ibrida.

Nome	Tipo	Descrizione
countAndFacetMode	HybridCountAndFacetMode	Determina se il conteggio e i facet devono includere tutti i documenti che corrispondono alla query di ricerca o solo i documenti recuperati all'interno della finestra 'maxTextRecallSize'.
maxTextRecallSize	integer (int32)	Determina il numero massimo di documenti che devono essere recuperati dalla parte della query di testo di una richiesta di ricerca ibrida. Tali documenti saranno combinati con i documenti corrispondenti 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 più documenti (usando i parametri top e skip), al costo di un maggiore utilizzo delle risorse e di una latenza più elevata. Il valore deve essere compreso tra 1 e 10.000. L'impostazione predefinita è 1000.

QueryAnswerResult

Oggetto

Una risposta è un passaggio di testo estratto dal contenuto dei documenti più rilevanti che corrispondono alla query. Le risposte vengono estratte dai primi risultati della ricerca. I candidati alle risposte vengono assegnati punteggi e vengono selezionate le risposte principali.

Nome	Tipo	Descrizione
highlights	string	Stesso passaggio di testo della proprietà Text con le frasi di testo evidenziate più rilevanti per la query.
key	string	La chiave del documento da cui è stata estratta la risposta.
score	number (double)	Il valore del punteggio rappresenta la pertinenza della risposta per la query rispetto ad altre risposte restituite per la query.
text	string	Il passaggio di testo estratto dal contenuto del documento come risposta.

QueryAnswerType

Enumerazione

Questo parametro è valido solo se il tipo di query è semantic. Se impostata, la query restituisce le risposte estratte dai passaggi chiave nei documenti con il punteggio più alto. Il numero di risposte restituite può essere configurato aggiungendo il carattere | pipe seguito dall'opzione count-<number of answers> dopo il valore del parametro answers, ad esempio extractive|count-3. Il conteggio predefinito è 1. La soglia di confidenza può essere configurata aggiungendo il carattere | pipe seguito dall'opzione threshold-<confidence threshold> dopo il valore del parametro answers, ad esempio extractive|threshold-0.9. La soglia predefinita è 0,7. La lunghezza massima dei caratteri delle risposte può essere configurata aggiungendo il carattere pipe '|' seguito dal 'numero di conteggio< della lunghezza> massima dei caratteri', ad esempio 'extractive|maxcharlength-600'.

Valore	Descrizione
none	Non restituisce risposte per la query.
extractive	Estrae i candidati di risposta dal contenuto dei documenti restituiti in risposta a una query espressa come domanda in linguaggio naturale.

QueryCaptionResult

Oggetto

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 le frasi evidenziate più rilevanti per la query.
text	string	Un passaggio di testo rappresentativo estratto dal documento più pertinente alla query di ricerca.

QueryCaptionType

Enumerazione

Questo parametro è valido solo se il tipo di query è semantic. Se impostata, la query restituisce le didascalie estratte dai passaggi chiave nei documenti classificati più alti. Quando Didascalie è impostato su extractive, l'evidenziazione è abilitata per impostazione predefinita e può essere configurata aggiungendo il carattere | pipe seguito dall'opzione highlight-<true/false> , ad esempio extractive|highlight-true. Il valore predefinito è None. La lunghezza massima dei caratteri delle didascalie può essere configurata aggiungendo il carattere pipe '|' seguito dal 'numero di conteggio< della lunghezza> massima dei caratteri', ad esempio 'extractive|maxcharlength-600'.

Valore	Descrizione
none	Non restituire didascalie per la query.
extractive	Estrae le didascalie dai documenti corrispondenti che contengono passaggi rilevanti per la query di ricerca.

QueryDebugMode

Enumerazione

Abilita uno strumento di debug che può essere utilizzato per esplorare ulteriormente i risultati della ricerca. È possibile abilitare più modalità di debug contemporaneamente separandole con un | carattere, ad esempio: semantic|queryRewrites.

Valore	Descrizione
disabled	Non verranno restituite informazioni di debug delle query.
semantic	Consente all'utente di esplorare ulteriormente i risultati classificati.
vector	Consente all'utente di esplorare ulteriormente i risultati delle query ibride e vettoriali.
queryRewrites	Consente all'utente di esplorare l'elenco di riscritture delle query generate per la richiesta di ricerca.
innerHits	Consente all'utente di recuperare le informazioni sul punteggio relative ai vettori corrispondenti all'interno di una raccolta di tipi complessi.
all	Attivare tutte le opzioni di debug.

QueryLanguage

Enumerazione

Lingua della query.

Valore	Descrizione
none	Linguaggio di query non specificato.
en-us	Valore della lingua di query per l'inglese (Stati Uniti).
en-gb	Interrogare il valore della lingua per l'inglese (Gran Bretagna).
en-in	Valore della lingua di query per l'inglese (India).
en-ca	Valore della lingua di query per l'inglese (Canada).
en-au	Valore della lingua di query per l'inglese (Australia).
fr-fr	Valore della lingua di query per il francese (Francia).
fr-ca	Valore della lingua della query per il francese (Canada).
de-de	Valore della lingua di query per il tedesco (Germania).
es-es	Valore della lingua di query per lo spagnolo (Spagna).
es-mx	Valore della lingua di query per lo spagnolo (Messico).
zh-cn	Valore della lingua di query per il cinese (Cina).
zh-tw	Valore della lingua di query per il cinese (Taiwan).
pt-br	Valore della lingua di query per il portoghese (Brasile).
pt-pt	Valore della lingua di query per il portoghese (Portogallo).
it-it	Interrogare il valore della lingua per l'italiano (Italia).
ja-jp	Valore della lingua di query per il giapponese (Giappone).
ko-kr	Valore della lingua di query per il coreano (Corea).
ru-ru	Valore della lingua di query per il russo (Russia).
cs-cz	Valore della lingua di query per il ceco (Repubblica ceca).
nl-be	Valore della lingua di query per l'olandese (Belgio).
nl-nl	Valore della lingua di query per l'olandese (Paesi Bassi).
hu-hu	Interrogare il valore della lingua per l'ungherese (Ungheria).
pl-pl	Valore della lingua di query per il polacco (Polonia).
sv-se	Interrogare il valore della lingua per lo svedese (Svezia).
tr-tr	Valore della lingua di query per il turco (Turchia).
hi-in	Valore della lingua di query per l'hindi (India).
ar-sa	Interrogare il valore della lingua per l'arabo (Arabia Saudita).
ar-eg	Valore della lingua di query per l'arabo (Egitto).
ar-ma	Valore della lingua di query per l'arabo (Marocco).
ar-kw	Interrogare il valore della lingua per l'arabo (Kuwait).
ar-jo	Interrogare il valore della lingua per l'arabo (Giordania).
da-dk	Valore della lingua di query per il danese (Danimarca).
no-no	Valore della lingua di query per il norvegese (Norvegia).
bg-bg	Valore della lingua di query per il bulgaro (Bulgaria).
hr-hr	Interrogare il valore della lingua per il croato (Croazia).
hr-ba	Interrogare il valore della lingua per il croato (Bosnia ed Erzegovina).
ms-my	Valore della lingua di query per il malese (Malesia).
ms-bn	Interrogare il valore della lingua per il malese (Brunei Darussalam).
sl-sl	Interrogare il valore della lingua per lo sloveno (Slovenia).
ta-in	Valore della lingua di query per il tamil (India).
vi-vn	Valore della lingua di query per il vietnamita (Vietnam).
el-gr	Interrogare il valore della lingua per il greco (Grecia).
ro-ro	Valore della lingua di query per il rumeno (Romania).
is-is	Interrogare il valore della lingua per l'islandese (Islanda).
id-id	Valore della lingua di query per l'indonesiano (Indonesia).
th-th	Interrogare il valore della lingua per Thai (Thailandia).
lt-lt	Valore della lingua di query per il lituano (Lituania).
uk-ua	Valore della lingua di query per l'ucraino (Ucraina).
lv-lv	Interrogare il valore della lingua per il lettone (Lettonia).
et-ee	Valore della lingua di query per l'estone (Estonia).
ca-es	Interrogare il valore della lingua per il catalano.
fi-fi	Valore della lingua di query per il finlandese (Finlandia).
sr-ba	Interrogare il valore della lingua per il serbo (Bosnia ed Erzegovina).
sr-me	Interrogare il valore della lingua per il serbo (Montenegro).
sr-rs	Interrogare il valore della lingua per il serbo (Serbia).
sk-sk	Valore della lingua di query per lo slovacco (Slovacchia).
nb-no	Valore della lingua di query per il norvegese (Norvegia).
hy-am	Valore della lingua di query per l'armeno (Armenia).
bn-in	Valore della lingua di query per il bengalese (India).
eu-es	Valore della lingua di query per il basco.
gl-es	Valore della lingua di query per il galiziano.
gu-in	Valore della lingua di query per il gujarati (India).
he-il	Valore della lingua di query per l'ebraico (Israele).
ga-ie	Interrogare il valore della lingua per l'irlandese (Irlanda).
kn-in	Valore della lingua di query per Kannada (India).
ml-in	Valore della lingua di query per il malayalam (India).
mr-in	Valore della lingua di query per Marathi (India).
fa-ae	Valore della lingua di query per il persiano (Emirati Arabi Uniti).
pa-in	Valore della lingua di query per il punjabi (India).
te-in	Valore della lingua di query per Telugu (India).
ur-pk	Valore della lingua di query per l'urdu (Pakistan).

QueryResultDocumentRerankerInput

Oggetto

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 di parole chiave utilizzati per l'arricchimento semantico.
title	string	Stringa non elaborata per il campo del titolo utilizzato per l'arricchimento semantico.

QueryResultDocumentSemanticField

Oggetto

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	SemanticFieldState	Il modo in cui il campo è stato utilizzato per il processo di arricchimento semantico (completamente utilizzato, parzialmente utilizzato o non utilizzato)

QueryResultDocumentSubscores

Oggetto

Suddivisione dei caratteri di sottolineatura tra i componenti di query di testo e vettore della query di ricerca per questo documento. Ogni query vettoriale viene visualizzata come oggetto separato nello stesso ordine in cui sono stati ricevuti.

Nome	Tipo	Descrizione
documentBoost	number (double)	Punteggio BM25 o Classico per la parte di testo della query.
text	TextResult	Punteggio BM25 o Classico per la parte di testo della query.
vectors	<string,  SingleVectorFieldResult>	La somiglianza vettoriale e

QueryRewritesDebugInfo

Oggetto

Contiene informazioni di debug specifiche per la riscrittura delle query.

Nome	Tipo	Descrizione
text	QueryRewritesValuesDebugInfo	Elenco delle riscritture delle query generate per la query di testo.
vectors	QueryRewritesValuesDebugInfo[]	Elenco delle riscritture delle query generate per le query di testo vettorizzabili.

QueryRewritesType

Enumerazione

Questo parametro è valido solo se il tipo di query è semantic. Quando QueryRewrites è impostato su generative, i termini della query vengono inviati a un modello di generazione che produrrà 10 riscritture (impostazione predefinita) per aumentare il richiamo della richiesta. Il conteggio richiesto può essere configurato aggiungendo il carattere | pipe seguito dall'opzione count-<number of rewrites> , ad esempio generative|count-3. Il valore predefinito è None.

Valore	Descrizione
none	Non generare ulteriori riscritture di query per questa query.
generative	Generare termini di query alternativi per aumentare il richiamo di una richiesta di ricerca.

QueryRewritesValuesDebugInfo

Oggetto

Contiene informazioni di debug specifiche per la riscrittura delle query.

Nome	Tipo	Descrizione
inputQuery	string	Testo di input per il modello di riscrittura delle query generative. In alcuni casi, la query dell'utente e l'input per il modello generativo non sono identici.
rewrites	string[]	Elenco delle riscritture delle query.

QuerySpellerType

Enumerazione

Migliorare il richiamo della ricerca correggendo i singoli termini di query di ricerca.

Valore	Descrizione
none	Ortografia non abilitata.
lexicon	Il correttore ortografico corregge i singoli termini di query utilizzando un lessico statico per la lingua specificata dal parametro queryLanguage.

QueryType

Enumerazione

Specifica la sintassi della query di ricerca. Il valore predefinito è 'simple'. Utilizzare 'full' se la query utilizza la sintassi della query Lucene e 'semantic' se la sintassi della query non è necessaria.

Valore	Descrizione
simple	Utilizza la sintassi di query semplice per le ricerche. Il testo di ricerca viene interpretato utilizzando un semplice linguaggio di query che consente l'uso di simboli come +, * e "". Per impostazione predefinita, le query vengono valutate in tutti i campi in cui è possibile eseguire la ricerca, a meno che non venga specificato il parametro searchFields.
full	Utilizza la sintassi di query Lucene completa per le ricerche. Il testo di ricerca viene interpretato utilizzando il linguaggio di query Lucene, che consente ricerche specifiche per campo e ponderate, oltre ad altre funzionalità avanzate.
semantic	Ideale per query espresse in linguaggio naturale anziché con parole chiave. Migliora la precisione dei risultati di ricerca riclassificando i primi risultati di ricerca utilizzando un modello di classificazione addestrato sul corpus Web.

ScoringStatistics

Enumerazione

Un valore che specifica se si desidera calcolare le statistiche di punteggio (ad esempio la frequenza dei documenti) a livello globale per un punteggio più coerente o a livello locale, per una latenza inferiore. Il valore predefinito è 'locale'. Utilizza "globale" per aggregare le statistiche di punteggio a livello globale prima di segnare. L'uso delle statistiche di punteggio globali può aumentare la latenza delle query di ricerca.

Valore	Descrizione
local	Le statistiche di punteggio verranno calcolate localmente per ridurre la latenza.
global	Le statistiche di punteggio saranno calcolate a livello globale per un punteggio più coerente.

SearchDocumentsResult

Oggetto

Risposta contenente i risultati della ricerca da un indice.

Nome	Tipo	Descrizione
@odata.count	integer (int64)	Conteggio totale dei risultati rilevati dall'operazione di ricerca oppure Null se il conteggio non è stato richiesto. Se presente, il conteggio può essere maggiore del numero di risultati in questa risposta. Questo problema può verificarsi se si utilizzano i parametri $top o $skip o se la query non è in grado di restituire tutti i documenti richiesti in un'unica risposta.
@odata.nextLink	string	URL di continuazione restituito quando la query non è in grado di restituire tutti i risultati richiesti in un'unica risposta. È possibile utilizzare questo URL per formulare un'altra richiesta di ricerca GET o POST per ottenere la parte successiva della risposta di ricerca. Assicurati di utilizzare lo stesso verbo (GET o POST) della richiesta che ha prodotto questa risposta.
@search.answers	QueryAnswerResult[]	Risposte ai risultati della query per l'operazione di ricerca; Null se il parametro di query answers non è stato specificato o impostato su 'none'.
@search.coverage	number (double)	Valore che indica la percentuale dell'indice incluso nella query oppure null se minimumCoverage non è stato specificato nella richiesta.
@search.debug	DebugInfo	Eseguire il debug delle informazioni applicabili ai risultati della ricerca nel suo complesso.
@search.facets	object	Risultati della query facet per l'operazione di ricerca, organizzati come raccolta di bucket per ogni campo in base a facet; Null se la query non include espressioni facet.
@search.nextPageParameters	SearchRequest	Payload JSON di continuazione restituito quando la query non è in grado di restituire tutti i risultati richiesti in un'unica risposta. Puoi usare questo JSON insieme a
@search.semanticPartialResponseReason	SemanticErrorReason	Motivo per cui è stata restituita una risposta parziale per una richiesta di classificazione semantica.
@search.semanticPartialResponseType	SemanticSearchResultsType	Tipo di risposta parziale restituita per una richiesta di classificazione semantica.
@search.semanticQueryRewritesResultType	SemanticQueryRewritesResultType	Tipo di riscrittura della query utilizzata per recuperare i documenti.
value	SearchResult[]	Sequenza di risultati restituiti dalla query.

SearchMode

Enumerazione

Specifica se è necessario trovare una corrispondenza tra uno o tutti i termini di ricerca per poter conteggiare il documento come corrispondenza.

Valore	Descrizione
any	Per poter contare il documento come corrispondenza, è necessario trovare una corrispondenza tra i termini di ricerca.
all	Tutti i termini di ricerca devono essere abbinati per poter contare il documento come corrispondenza.

SearchRequest

Oggetto

Parametri per il filtro, l'ordinamento, il facet, il paging e altri comportamenti delle query di ricerca.

Nome	Tipo	Descrizione
answers	QueryAnswerType	Valore che specifica se le risposte devono essere restituite come parte della risposta di ricerca.
captions	QueryCaptionType	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. Il valore predefinito è false. L'impostazione di questo valore su true può avere un impatto sulle prestazioni. Si noti che il conteggio restituito è un'approssimazione.
debug	QueryDebugMode	Abilita uno strumento di debug che può essere utilizzato per esplorare ulteriormente i risultati riclassificati.
facets	string[]	Elenco di espressioni di facet da applicare alla query di ricerca. Ogni espressione di facet contiene un nome di campo, seguito facoltativamente da un elenco delimitato da virgole di coppie nome:valore.
filter	string	OData $filter un'espressione da applicare alla query di ricerca.
highlight	string	L'elenco delimitato da virgole dei nomi dei campi da utilizzare per le evidenziazioni dei risultati. Per l'evidenziazione dei risultati è possibile utilizzare solo i campi in cui è possibile effettuare la ricerca.
highlightPostTag	string	Un tag stringa che viene aggiunto per colpire le evidenziazioni. Deve essere impostato con highlightPreTag. Il valore predefinito è </em>.
highlightPreTag	string	Un tag stringa anteposto per colpire le evidenziazioni. Deve essere impostato con highlightPostTag. Il valore predefinito è <em>.
hybridSearch	HybridSearch	Parametri di query per configurare i comportamenti di ricerca ibrida.
minimumCoverage	number (double)	Un 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.
orderby	string	L'elenco delimitato da virgole di OData $orderby espressioni in base alle quali 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'ascendente o desc per indicare l'ascendente. Il valore predefinito è l'ordine crescente. I pareggi saranno risolti dai punteggi dei documenti. Se non viene specificata alcuna $orderby, l'ordinamento predefinito è decrescente in base al punteggio di corrispondenza del documento. Ci possono essere al massimo 32 $orderby clausole.
queryLanguage	QueryLanguage	Valore che specifica la lingua della query di ricerca.
queryRewrites	QueryRewritesType	Valore che specifica se è necessario generare riscritture delle query per aumentare la query di ricerca.
queryType	QueryType	Valore che specifica la sintassi della query di ricerca. Il valore predefinito è 'simple'. Utilizzare 'full' se la query utilizza la sintassi della query Lucene.
scoringParameters	string[]	Elenco dei valori dei parametri da utilizzare nelle funzioni di assegnazione dei punteggi (ad esempio, referencePointParameter) utilizzando il formato nome-valori. Ad esempio, se il profilo di punteggio definisce una funzione con un parametro denominato 'mylocation', la stringa del parametro sarà "mylocation--122.2,44.8" (senza virgolette).
scoringProfile	string	Il nome di un profilo di punteggio per valutare i punteggi delle corrispondenze per i documenti corrispondenti al fine di ordinare i risultati.
scoringStatistics	ScoringStatistics	Un valore che specifica se si desidera calcolare le statistiche di punteggio (ad esempio la frequenza dei documenti) a livello globale per un punteggio più coerente o a livello locale, per una latenza inferiore. Il valore predefinito è 'locale'. Utilizza "globale" per aggregare le statistiche di punteggio a livello globale prima di segnare. L'uso delle statistiche di punteggio globali può aumentare la latenza delle query di ricerca.
search	string	Un'espressione di query di ricerca full-text; Utilizzare "*" o omettere questo parametro per la corrispondenza di tutti i documenti.
searchFields	string	Elenco delimitato da virgole di nomi di campo in cui definire l'ambito della ricerca full-text. Quando si utilizza la ricerca sul campo (fieldName:searchExpression) in una query Lucene completa, i nomi dei campi di ogni espressione di ricerca sui campi hanno la precedenza su tutti i nomi dei campi elencati in questo parametro.
searchMode	SearchMode	Valore che specifica se è necessario trovare una corrispondenza tra uno o tutti i termini di ricerca per poter conteggiare il documento come corrispondenza.
select	string	L'elenco delimitato da virgole dei 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à utilizzata durante l'elaborazione di documenti per query di tipo semantico.
semanticErrorHandling	SemanticErrorMode	Consente all'utente di scegliere se una chiamata semantica deve avere esito negativo completo (comportamento predefinito/corrente) o se deve restituire risultati parziali.
semanticFields	string	Elenco delimitato da virgole dei nomi dei campi utilizzati per la classificazione semantica.
semanticMaxWaitInMilliseconds	integer (int32) minimum: 700	Consente all'utente di impostare un limite superiore per la quantità di tempo necessaria per il completamento dell'elaborazione dell'arricchimento semantico prima che la richiesta abbia esito negativo.
semanticQuery	string	Consente di impostare una query di ricerca separata che verrà utilizzata esclusivamente per il riposizionamento semantico, le didascalie semantiche e le risposte semantiche. È utile per gli scenari in cui è necessario utilizzare query diverse tra la fase di recupero e classificazione della base e la fase semantica L2.
sessionId	string	Un valore da utilizzare per creare una sessione permanente, che può aiutare a ottenere risultati più coerenti. Finché viene utilizzato lo stesso sessionId, verrà effettuato un tentativo ottimale per indirizzare lo stesso set di repliche. Tenere presente che il riutilizzo ripetuto degli stessi valori sessionID può interferire con il bilanciamento del carico delle richieste tra le repliche e influire negativamente sulle prestazioni del servizio di ricerca. Il valore utilizzato come sessionId non può iniziare con un carattere '_'.
skip	integer (int32)	Il 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 utilizzare skip a causa di questa limitazione, è consigliabile utilizzare orderby su una chiave ordinata completamente e filtrare con una query di intervallo.
speller	QuerySpellerType	Un valore che specifica il tipo di ortografia da usare per correggere singoli termini di ricerca di ricerca.
top	integer (int32)	Il numero di risultati della ricerca da recuperare. Questo può essere utilizzato insieme a $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 utilizzato per inviare un'altra richiesta di ricerca per la pagina successiva dei risultati.
vectorFilterMode	VectorFilterMode	Determina se i filtri vengono applicati prima o dopo l'esecuzione della ricerca vettoriale. Il valore predefinito è 'preFilter' per i nuovi indici.
vectorQueries	VectorQuery[]: VectorizableImageBinaryQuery[] VectorizableImageUrlQuery[] VectorizableTextQuery[] VectorizedQuery[]	Parametri di query per le query di ricerca ibrida e vettoriali.

SearchResult

Oggetto

Contiene un documento trovato da una query di ricerca, oltre ai metadati associati.

Nome	Tipo	Descrizione
@search.captions	QueryCaptionResult[]	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 'semantico'.
@search.documentDebugInfo	DocumentDebugInfo	Contiene informazioni di debug che possono essere usate per esplorare ulteriormente i risultati della ricerca.
@search.highlights	object	Frammenti di testo del documento che indicano i termini di ricerca corrispondenti, organizzati in base a ciascun campo applicabile; null se l'evidenziazione dei risultati non è stata abilitata per la query.
@search.rerankerBoostedScore	number (double)	Il punteggio di pertinenza calcolato aumentando il punteggio Reranker. I risultati della ricerca sono ordinati per RerankerScore/RerankerBoostedScore basandosi su useScoringProfileBoostedRanking nella Configurazione Semantica. RerankerBoostedScore viene restituito solo per query di tipo 'semantica'.
@search.rerankerScore	number (double)	Punteggio di pertinenza calcolato dal classificatore semantico per i primi risultati di ricerca. I risultati della ricerca vengono ordinati prima in base al RerankerScore e poi in base al punteggio. RerankerScore viene restituito solo per le query di tipo 'semantico'.
@search.score	number (double)	Punteggio di pertinenza del documento rispetto ad altri documenti restituiti dalla query.

SearchScoreThreshold

Oggetto

I risultati della query vettoriale filtreranno in base al '

Nome	Tipo	Descrizione
kind	string: searchScore	Tipo di soglia.
value	number (double)	La soglia filtrerà in base al '

SemanticDebugInfo

Oggetto

Contiene informazioni di debug specifiche per le richieste di classificazione semantica.

Nome	Tipo	Descrizione
contentFields	QueryResultDocumentSemanticField[]	I campi di contenuto inviati al processo di arricchimento semantico, nonché il modo in cui sono stati utilizzati
keywordFields	QueryResultDocumentSemanticField[]	I campi delle parole chiave inviati al processo di arricchimento semantico, nonché il modo in cui sono stati utilizzati
rerankerInput	QueryResultDocumentRerankerInput	Stringhe concatenate non elaborate inviate al processo di arricchimento semantico.
titleField	QueryResultDocumentSemanticField	Il campo del titolo inviato al processo di arricchimento semantico e la modalità di utilizzo

SemanticErrorMode

Enumerazione

Permette all'utente di scegliere se una chiamata semantica fallisca completamente o di restituire risultati parziali.

Valore	Descrizione
partial	Se l'elaborazione semantica fallisce, vengono comunque restituiti risultati parziali. La definizione dei risultati parziali dipende da quale passaggio semantico ha fallito e qual è stata la ragione del fallimento.
fail	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.

SemanticErrorReason

Enumerazione

Motivo per cui è stata restituita una risposta parziale per una richiesta di classificazione semantica.

Valore	Descrizione
maxWaitExceeded	Se semanticMaxWaitInMilliseconds è stato impostato e la durata dell'elaborazione semantica ha superato tale valore. Sono stati restituiti solo i risultati di base.
capacityOverloaded	La richiesta è stata limitata. Sono stati restituiti solo i risultati di base.
transient	Almeno un passaggio del processo semantico è fallito.

SemanticFieldState

Enumerazione

Il modo in cui il campo veniva utilizzato per il processo di arricchimento semantico.

Valore	Descrizione
used	Il campo è stato completamente utilizzato per l'arricchimento semantico.
unused	Il campo non è stato utilizzato per l'arricchimento semantico.
partial	Il campo è stato parzialmente utilizzato per l'arricchimento semantico.

SemanticQueryRewritesResultType

Enumerazione

Tipo di riscrittura della query utilizzata per questa richiesta.

Valore	Descrizione
originalQueryOnly	Le riscritture delle query non sono state generate correttamente per questa richiesta. Per recuperare i risultati è stata usata solo la query originale.

SemanticSearchResultsType

Enumerazione

Tipo di risposta parziale restituita per una richiesta di classificazione semantica.

Valore	Descrizione
baseResults	Risultati senza alcun arricchimento semantico o riposizionamento.
rerankedResults	I risultati sono stati riclassificati con il modello di reranker e includeranno didascalie semantiche. Non includeranno alcuna risposta, evidenziazione delle risposte o evidenziazione delle didascalie.

SingleVectorFieldResult

Oggetto

Risultato di un singolo campo vettoriale. Entrambi

Nome	Tipo	Descrizione
searchScore	number (double)	Il valore di
vectorSimilarity	number (double)	Punteggio di somiglianza vettoriale per questo documento. Si noti che si tratta della definizione canonica della metrica di somiglianza, non della versione "distance". Ad esempio, la somiglianza del coseno invece della distanza del coseno.

TextResult

Oggetto

Punteggio BM25 o Classico per la parte di testo della query.

Nome	Tipo	Descrizione
searchScore	number (double)	Punteggio BM25 o Classico per la parte di testo della query.

VectorFilterMode

Enumerazione

Determina se i filtri vengono applicati prima o dopo l'esecuzione della ricerca vettoriale.

Valore	Descrizione
postFilter	Il filtro verrà applicato dopo la restituzione del set candidato di risultati vettoriali. A seconda della selettività del filtro, questo può comportare un minor numero di risultati rispetto a quanto richiesto dal parametro 'k'.
preFilter	Il filtro verrà applicato prima della query di ricerca.
strictPostFilter	Il filtro verrà applicato dopo che viene restituito il set globale di risultati vettoriali candidati top-k. Ciò si tradurrà in un numero di risultati inferiore a quello richiesto dal parametro 'k'.

VectorizableImageBinaryQuery

Oggetto

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

Nome	Tipo	Descrizione
base64Image	string	Il binario codificato in base 64 di un'immagine da vettorializzare per eseguire una query di ricerca vettoriale.
exhaustive	boolean	Se true, attiva una ricerca completa k-nearest 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.
filterOverride	string	Espressione di filtro OData da applicare a questa query vettoriale specifica. Se non viene definita alcuna espressione di filtro a livello di vettore, viene invece usata l'espressione definita nel parametro di filtro di primo livello.
k	integer (int32)	Numero di vicini più vicini da restituire come top hit.
kind	string: imageBinary	Tipo di query.
oversampling	number (double)	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.
perDocumentVectorLimit	integer (int32)	Controlla il numero di vettori che possono essere trovati da ciascun documento in una query di ricerca vettoriale. L'impostazione su 1 garantisce la corrispondenza di un vettore per documento, garantendo che i risultati provengano da documenti distinti. L'impostazione su 0 (illimitato) consente di abbinare più vettori rilevanti dello stesso documento. Il valore predefinito è 0.
threshold	VectorThreshold: SearchScoreThreshold VectorSimilarityThreshold	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 (float)	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 è 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

Oggetto

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 completa k-nearest 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.
filterOverride	string	Espressione di filtro OData da applicare a questa query vettoriale specifica. Se non viene definita alcuna espressione di filtro a livello di vettore, viene invece usata l'espressione definita nel parametro di filtro di primo livello.
k	integer (int32)	Numero di vicini più vicini da restituire come top hit.
kind	string: imageUrl	Tipo di query.
oversampling	number (double)	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.
perDocumentVectorLimit	integer (int32)	Controlla il numero di vettori che possono essere trovati da ciascun documento in una query di ricerca vettoriale. L'impostazione su 1 garantisce la corrispondenza di un vettore per documento, garantendo che i risultati provengano da documenti distinti. L'impostazione su 0 (illimitato) consente di abbinare più vettori rilevanti dello stesso documento. Il valore predefinito è 0.
threshold	VectorThreshold: SearchScoreThreshold VectorSimilarityThreshold	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 (float)	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 è 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

Oggetto

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 completa k-nearest 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.
filterOverride	string	Espressione di filtro OData da applicare a questa query vettoriale specifica. Se non viene definita alcuna espressione di filtro a livello di vettore, viene invece usata l'espressione definita nel parametro di filtro di primo livello.
k	integer (int32)	Numero di vicini più vicini da restituire come top hit.
kind	string: text	Tipo di query.
oversampling	number (double)	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.
perDocumentVectorLimit	integer (int32)	Controlla il numero di vettori che possono essere trovati da ciascun documento in una query di ricerca vettoriale. L'impostazione su 1 garantisce la corrispondenza di un vettore per documento, garantendo che i risultati provengano da documenti distinti. L'impostazione su 0 (illimitato) consente di abbinare più vettori rilevanti dello stesso documento. Il valore predefinito è 0.
queryRewrites	QueryRewritesType	Può essere configurato per consentire a un modello generativo di riscrivere la query prima di inviarla per essere vettorializzata.
text	string	Testo da vettorizzare per eseguire una query di ricerca vettoriale.
threshold	VectorThreshold: SearchScoreThreshold VectorSimilarityThreshold	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 (float)	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 è 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.

VectorizedQuery

Oggetto

Parametri di query da usare per la ricerca vettoriale quando viene specificato un valore di vettore non elaborato.

Nome	Tipo	Descrizione
exhaustive	boolean	Se true, attiva una ricerca completa k-nearest 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.
filterOverride	string	Espressione di filtro OData da applicare a questa query vettoriale specifica. Se non viene definita alcuna espressione di filtro a livello di vettore, viene invece usata l'espressione definita nel parametro di filtro di primo livello.
k	integer (int32)	Numero di vicini più vicini da restituire come top hit.
kind	string: vector	Tipo di query.
oversampling	number (double)	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.
perDocumentVectorLimit	integer (int32)	Controlla il numero di vettori che possono essere trovati da ciascun documento in una query di ricerca vettoriale. L'impostazione su 1 garantisce la corrispondenza di un vettore per documento, garantendo che i risultati provengano da documenti distinti. L'impostazione su 0 (illimitato) consente di abbinare più vettori rilevanti dello stesso documento. Il valore predefinito è 0.
threshold	VectorThreshold: SearchScoreThreshold VectorSimilarityThreshold	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.
vector	number[] (float)	Rappresentazione vettoriale di una query di ricerca.
weight	number (float)	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 è 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.

VectorQueryKind

Enumerazione

Tipo di query vettoriale eseguita.

Valore	Descrizione
vector	Query vettoriale in cui viene fornito un valore vettoriale non elaborato.
text	Query vettoriale in cui viene fornito un valore di testo che deve essere vettorializzato.
imageUrl	Query vettoriale in cui viene fornito un URL che rappresenta un valore di immagine che deve essere vettorializzato.
imageBinary	Query vettoriale in cui viene fornito un file binario codificato in base 64 di un'immagine che deve essere vettorializzata.

VectorsDebugInfo

Oggetto

"Contiene informazioni di debug specifiche per la ricerca vettoriale e ibrida.")

Nome	Tipo	Descrizione
subscores	QueryResultDocumentSubscores	La suddivisione dei punteggi parziali del documento prima del metodo di fusione/combinazione del set di risultati scelto, ad esempio RRF.

VectorSimilarityThreshold

Oggetto

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: vectorSimilarity	Tipo di soglia.
value	number (double)	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

Enumerazione

Il tipo di soglia usata per filtrare le query vettoriali.

Valore	Descrizione
vectorSimilarity	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.
searchScore	I risultati della query vettoriale verranno filtrati in base al valore "@search.score". Si noti che questo è il @search.score restituito come parte della risposta di ricerca. La direzione della soglia verrà scelta per @search.scoresuperiore.