Semantische Suche über Ordner hinweg

Führt eine semantische (Vektor-)Suche über Dateien in Dokumentenordnern durch. Gibt die relevantesten Datei-Abschnitte zurück, gerankt nach Kosinus-Ähnlichkeit. Berücksichtigt die Ordnerberechtigungen des API-Keys.

POSThttps://api.deutschlandgpt.de/v2/document-folders/search

Beispielaufruf

curl https://api.deutschlandgpt.de/v2/document-folders/search \
  -X POST \
  -H "Authorization: Bearer $DGPT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "string",
  "folder_ids": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "max_results": 10,
  "similarity_threshold": 0.3
}'

curl https://api.deutschlandgpt.de/v2/document-folders/search \
  -X POST \
  -H "Authorization: Bearer $DGPT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "string",
  "folder_ids": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "max_results": 10,
  "similarity_threshold": 0.3
}'

import os, requests

response = requests.post(
    "https://api.deutschlandgpt.de/v2/document-folders/search",
    headers={"Authorization": f"Bearer {os.environ['DGPT_API_KEY']}"},
    json={
        "query": "string",
        "folder_ids": [
            "00000000-0000-0000-0000-000000000000"
        ],
        "max_results": 10,
        "similarity_threshold": 0.3
    },
)

print(response.json())

import os, requests

response = requests.post(
    "https://api.deutschlandgpt.de/v2/document-folders/search",
    headers={"Authorization": f"Bearer {os.environ['DGPT_API_KEY']}"},
    json={
        "query": "string",
        "folder_ids": [
            "00000000-0000-0000-0000-000000000000"
        ],
        "max_results": 10,
        "similarity_threshold": 0.3
    },
)

print(response.json())

const response = await fetch('https://api.deutschlandgpt.de/v2/document-folders/search', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DGPT_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "query": "string",
    "folder_ids": [
      "00000000-0000-0000-0000-000000000000"
    ],
    "max_results": 10,
    "similarity_threshold": 0.3
  }),
});

console.log(await response.json());

const response = await fetch('https://api.deutschlandgpt.de/v2/document-folders/search', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DGPT_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "query": "string",
    "folder_ids": [
      "00000000-0000-0000-0000-000000000000"
    ],
    "max_results": 10,
    "similarity_threshold": 0.3
  }),
});

console.log(await response.json());

Anfrage-Body

querystringerforderlich

Suchanfrage-Text

folder_idsstring<uuid>[]optional

Suche auf bestimmte Ordner-IDs einschränken. Weglassen, um alle zugänglichen Ordner zu durchsuchen.

max_resultsintegeroptional

Maximale Anzahl von Ergebnissen

similarity_thresholdnumberoptional

Minimaler Kosinus-Ähnlichkeitswert (0–1)

Antwort

200application/json

{
  "object": "list",
  "data": [
    {
      "file_id": "string",
      "file_name": "string",
      "file_type": "string",
      "folder_id": "00000000-0000-0000-0000-000000000000",
      "chunk_content": "string",
      "similarity_score": 0,
      "offset_start": 0,
      "offset_end": 0
    }
  ]
}

{
  "object": "list",
  "data": [
    {
      "file_id": "string",
      "file_name": "string",
      "file_type": "string",
      "folder_id": "00000000-0000-0000-0000-000000000000",
      "chunk_content": "string",
      "similarity_score": 0,
      "offset_start": 0,
      "offset_end": 0
    }
  ]
}

Suchergebnisse

objectstring

dataSearchResult[]

file_idstring

file_namestring

file_typestring

folder_idstring<uuid>

chunk_contentstring

similarity_scorenumber

offset_startinteger

offset_endinteger

Statuscodes

200

Suchergebnisse

object

401

Nicht autorisiert

402

Nicht genügend Guthaben oder Ausgabenlimit überschritten

Error

403

Erfordert einen Enterprise-Workspace