Knowledge base bulk upload

Masowy upload dokumentow do bazy wiedzy z reindex i statusem przetwarzania.

Kiedy tego uzyc

Uzyj tego przepisu, gdy chcesz: Wgrac wiele dokumentow i poczekac az RAG index bedzie gotowy.

Endpoint referencyjny: POST /knowledge/bases/{id}/documents.

Implementacja

Node.js

import { DarhimLabs } from "@darhimlabs/node";

const client = new DarhimLabs(process.env.DARHIMLABS_API_KEY!);
await client.knowledge.sources.create({ base_id: baseId, type: 'file', title, content });

Python

import os
from darhimlabs import DarhimLabs

client = DarhimLabs(api_key=os.environ["DARHIMLABS_API_KEY"])
client.knowledge.sources.create({'base_id': base_id, 'type': 'file', 'title': title, 'content': content})

PHP

<?php

$client = new DarhimLabs\Client(["api_key" => $_ENV["DARHIMLABS_API_KEY"]]);
$client->knowledge->sources->create(['base_id' => $baseId, 'type' => 'file', 'title' => $title, 'content' => $content]);

Ruby

client = DarhimLabs::Client.new(api_key: ENV["DARHIMLABS_API_KEY"])
client.knowledge.sources.create(base_id: base_id, type: 'file', title: title, content: content)

Test it

Wykonaj request w sandboxie z kluczem dl_test_....
Sprawdz X-Request-ID w odpowiedzi.
Dla webhookow uzyj Webhook Playground, zeby zobaczyc payload live.

Common pitfalls

Po uploadzie sprawdz status indeksowania. Nie wlaczaj bota na niegotowej bazie.
Loguj request_id i event_id, zeby support mogl odtworzyc problem.
Dla mutacji dodawaj Idempotency-Key, szczegolnie jesli request moze byc retryowany.

Production checklist

Dodaj retry z exponential backoff i jitterem.
Ogranicz scopes API key do minimalnego zestawu.
Monitoruj rate limit headers i latency P95.
Przetestuj bledy 401, 409, 422 i 429.