BaseVectorQuery interface
Die Abfrageparameter für Vektor- und Hybridsuchabfragen.
Eigenschaften
| exhaustive | Wenn wahr, löst eine vollständige k-nächste Nachbarsuche über alle Vektoren innerhalb des Vektorindex aus. Nützlich für Szenarien, in denen genaue Übereinstimmungen kritisch sind, z. B. das Bestimmen von Boden-Wahrheitswerten. |
| fields | Vektorfelder vom Typ Collection(Edm.Single), die in den durchsuchten Vektor einbezogen werden sollen. |
| filter |
Der OData-Filterausdruck, der auf diese spezifische Vektorabfrage angewendet werden soll. Wenn kein Filterausdruck auf Vektorebene definiert ist, wird stattdessen der im Filterparameter der obersten Ebene definierte Ausdruck verwendet. |
| kind | Bekannte Werte, die vom Dienst unterstützt werdenVektor-: Vektorabfrage, bei der ein unformatierter Vektorwert bereitgestellt wird. Text: Vektorabfrage, bei der ein Textwert bereitgestellt wird, der vektorisiert werden muss. imageUrl: Vektorabfrage, bei der eine URL angegeben wird, die einen Bildwert darstellt, der vektorisiert werden muss. imageBinary: Vektorabfrage, bei der eine Base64-kodierte Binärdatei eines Bildes bereitgestellt wird, das vektorisiert werden muss. |
| k |
Die Anzahl der nächsten Nachbarn, die als Toptreffer zurückgegeben werden sollen. |
| per |
Steuert, wie viele Vektoren aus jedem Dokument in einer Vektorsuchabfrage abgeglichen werden können. Wenn Sie den Wert auf 1 setzen, wird sichergestellt, dass maximal ein Vektor pro Dokument abgeglichen wird, wodurch sichergestellt wird, dass die Ergebnisse aus unterschiedlichen Dokumenten stammen. Wenn Sie den Wert auf 0 (unbegrenzt) setzen, können mehrere relevante Vektoren aus demselben Dokument abgeglichen werden. Standard ist "0". |
| threshold | Der Schwellenwert, der für Vektorabfragen verwendet wird. Beachten Sie, dass dies nur festgelegt werden kann, wenn alle "Felder" dieselbe Ähnlichkeitsmetrik verwenden. |
| weight | Relative Gewichtung der Vektorabfrage im Vergleich zu anderen Vektorabfragen und/oder der Textabfrage innerhalb derselben Suchanforderung. Dieser Wert wird verwendet, wenn die Ergebnisse mehrerer Bewertungslisten kombiniert werden, die von den verschiedenen Vektorabfragen und/oder den ergebnissen, die über die Textabfrage abgerufen wurden. Je höher die Gewichtung ist, desto höher sind die Dokumente, die dieser Abfrage entsprechen, in der endgültigen Rangfolge. Der Standardwert ist 1,0 und der Wert muss eine positive Zahl größer als 0 sein. |
Details zur Eigenschaft
exhaustive
Wenn wahr, löst eine vollständige k-nächste Nachbarsuche über alle Vektoren innerhalb des Vektorindex aus. Nützlich für Szenarien, in denen genaue Übereinstimmungen kritisch sind, z. B. das Bestimmen von Boden-Wahrheitswerten.
exhaustive?: boolean
Eigenschaftswert
boolean
fields
Vektorfelder vom Typ Collection(Edm.Single), die in den durchsuchten Vektor einbezogen werden sollen.
fields?: SearchFieldArray<TModel>
Eigenschaftswert
SearchFieldArray<TModel>
filterOverride
Der OData-Filterausdruck, der auf diese spezifische Vektorabfrage angewendet werden soll. Wenn kein Filterausdruck auf Vektorebene definiert ist, wird stattdessen der im Filterparameter der obersten Ebene definierte Ausdruck verwendet.
filterOverride?: string
Eigenschaftswert
string
kind
Bekannte Werte, die vom Dienst unterstützt werden
Vektor-: Vektorabfrage, bei der ein unformatierter Vektorwert bereitgestellt wird. Text: Vektorabfrage, bei der ein Textwert bereitgestellt wird, der vektorisiert werden muss. imageUrl: Vektorabfrage, bei der eine URL angegeben wird, die einen Bildwert darstellt, der vektorisiert werden muss. imageBinary: Vektorabfrage, bei der eine Base64-kodierte Binärdatei eines Bildes bereitgestellt wird, das vektorisiert werden muss.
kind: "text" | "vector" | "imageUrl" | "imageBinary"
Eigenschaftswert
"text" | "vector" | "imageUrl" | "imageBinary"
kNearestNeighborsCount
Die Anzahl der nächsten Nachbarn, die als Toptreffer zurückgegeben werden sollen.
kNearestNeighborsCount?: number
Eigenschaftswert
number
perDocumentVectorLimit
Steuert, wie viele Vektoren aus jedem Dokument in einer Vektorsuchabfrage abgeglichen werden können. Wenn Sie den Wert auf 1 setzen, wird sichergestellt, dass maximal ein Vektor pro Dokument abgeglichen wird, wodurch sichergestellt wird, dass die Ergebnisse aus unterschiedlichen Dokumenten stammen. Wenn Sie den Wert auf 0 (unbegrenzt) setzen, können mehrere relevante Vektoren aus demselben Dokument abgeglichen werden. Standard ist "0".
perDocumentVectorLimit?: number
Eigenschaftswert
number
threshold
Der Schwellenwert, der für Vektorabfragen verwendet wird. Beachten Sie, dass dies nur festgelegt werden kann, wenn alle "Felder" dieselbe Ähnlichkeitsmetrik verwenden.
threshold?: VectorThreshold
Eigenschaftswert
weight
Relative Gewichtung der Vektorabfrage im Vergleich zu anderen Vektorabfragen und/oder der Textabfrage innerhalb derselben Suchanforderung. Dieser Wert wird verwendet, wenn die Ergebnisse mehrerer Bewertungslisten kombiniert werden, die von den verschiedenen Vektorabfragen und/oder den ergebnissen, die über die Textabfrage abgerufen wurden. Je höher die Gewichtung ist, desto höher sind die Dokumente, die dieser Abfrage entsprechen, in der endgültigen Rangfolge. Der Standardwert ist 1,0 und der Wert muss eine positive Zahl größer als 0 sein.
weight?: number
Eigenschaftswert
number