Spreadsheet-typische Dokumente aktualisieren

Batch-Update von Spreadsheet-typischen Dokumenten. Das System führt der Reihe nach das Chunking/Slicing, das Embedding/Vektorisieren und schließlich den Austausch des alten durch den neuen Dokumenteninhalt durch, wobei die Dokumenten-ID erhalten bleibt.

Hinweis:
Das Embedding-Modell nutzt das Standardmodell und lässt sich nicht per API anpassen.
Es werden lediglich die Ergebnisse des Uploads zurückgegeben, nicht jedoch die endgültigen Embedding-Ergebnisse. Die finalen Ergebnisse können Sie über die API „Dokumentenstatus abfragen“ erhalten.

Request-Methode

PUT

Request-URL

https://api-${endpoint}.gptbots.ai/v1/bot/doc/spreadsheet/update

Authentifizierung der Anfrage

Weitere Informationen zur Authentifizierung finden Sie in der Übersicht.

Anfrage

Beispielanfrage

curl -X PUT 'https://api-${endpoint}.gptbots.ai/v1/bot/doc/spreadsheet/update' \ -H 'Authorization: Bearer ${API Key}' \ -H 'Content-Type: application/json' \ -d '{ "knowledge_base_id": "67457fea6f658672d6482542", "chunk_token": 700, "header_row": 5, "files": [ { "file_url": "https://www.gptbots.ai/doc/spreadsheet.xlsx", "source_url": "https://www.gptbots.ai/doc/spreadsheet.xlsx", "file_name": "spreadsheet_1.xlsx" } ] }'

                      
                      curl -X PUT 'https://api-${endpoint}.gptbots.ai/v1/bot/doc/spreadsheet/update' \
-H 'Authorization: Bearer ${API Key}' \
-H 'Content-Type: application/json' \
-d '{
    "knowledge_base_id": "67457fea6f658672d6482542",
    "chunk_token": 700,
    "header_row": 5,
    "files": [
        {
            "file_url": "https://www.gptbots.ai/doc/spreadsheet.xlsx",
            "source_url": "https://www.gptbots.ai/doc/spreadsheet.xlsx",
            "file_name": "spreadsheet_1.xlsx"
        }
    ]
}'

Dieser Codeblock im schwebenden Fenster

Anfrage-Header

Feld	Typ	Beschreibung
Authorization	Bearer ${API Key}	Verwenden Sie `Authorization: Bearer ${API Key}` zur Authentifizierung. Den API Key erhalten Sie auf der API-Key-Seite.
Content-Type	application/json	Datentyp, Wert ist `application/json`.

Anfrageparameter

Feld	Typ	Erforderlich	Beschreibung
files	Array<Object>	Ja	Liste der zu aktualisierenden Spreadsheet-typischen Dokumente. Es können bis zu 20 Dokumente gleichzeitig aktualisiert werden.
doc_id	String	Ja	Die ID des zu aktualisierenden Dokuments.
file_url	String	Nein	Die URL der hinzuzufügenden Datei. Unterstützte Formate: csv/xls/xlsx. Maximale Dateigröße: 10 MB. Hinweis: Entweder URL oder base64 muss angegeben werden. Falls beides angegeben ist, hat base64 Vorrang.
file_base64	String	Nein	Base64-kodierte Datei. Unterstützte Formate: csv/xls/xlsx. Maximale Dateigröße: 10 MB. Hinweis: Entweder URL oder base64 muss angegeben werden. Falls beides angegeben ist, hat base64 Vorrang.
source_url	String	Nein	Die Quell-URL des zu aktualisierenden Dokuments. Muss den URL-Formatvorgaben entsprechen. Bleibt das Feld leer, wird dieser Wert nicht aktualisiert. Um diesen Wert zu leeren, bitte `NULL` eingeben.
chunk_token	Integer	Nein	Maximale Token-Anzahl pro Wissens-Chunk beim Chunking. Standardwert: 600. Bereich: 1–1.000.
header_row	Integer	Nein	Maximale Anzahl der Kopfzeilen. Spreadsheet-Dokumente werden nach „Header + Datenzeilen“ gechunkt. Standardwert: 1. Bereich: 1–5.

Antwort

Beispielantwort

{ "doc": [ { "doc_id": "xxxxxx", "doc_name": "test_1.csv" }, { "doc_id": "xxxxxx", "doc_name": "test_2.xlsx" } ], "failed": [ "xxxxxx", "xxxxxx" ] }

                      
                      {
    "doc": [
        {
            "doc_id": "xxxxxx",
            "doc_name": "test_1.csv"
        },
        {
            "doc_id": "xxxxxx",
            "doc_name": "test_2.xlsx"
        }
    ],
    "failed": [
        "xxxxxx",
        "xxxxxx"
    ]
}

Dieser Codeblock im schwebenden Fenster

Erfolgsantwort

Feld	Typ	Beschreibung
doc	Array<Object>	Liste der erfolgreich aktualisierten Dokumente.
doc_id	String	ID des aktualisierten Dokuments.
doc_name	String	Name des aktualisierten Dokuments.
failed	Array<Object>	Liste der IDs der fehlgeschlagenen Dokumente.

Fehlerantwort

Feld	Typ	Beschreibung
code	Int	Fehlercode.
message	String	Details zum Fehler.