پرش به مطلب اصلی

مدیریت پایگاه دانش

مقدمه​

در این قسمت، مراحل کامل کار با پایگاه دانش توضیح داده شده است.

1. لیست پایگاه دانش ها​

این سرویس لیست تمام پایگاه دانش های موجود را برمی‌گرداند.

مسیر سرویس​

GET /api/v1/b2b/knowledge-bases/

هدرها​

هدرمقدار
AuthorizationToken api-token

نمونه فراخوانی​

curl --location 'http://app.houshyar24.ir/api/v1/b2b/knowledge-bases/' --header 'Authorization: Token <your-token>'

پاسخ موفق (200)​

[
    {
        "id": 20,
        "name": "kb",
        "file_id": null,
        "crawl_id": null,
        "linked_agents": 0,
        "segments_count": 0,
        "crawls_count": 0,
        "words_count": 0,
        "total_documents": 0,
        "total_available_documents": 0,
        "is_shared": false,
        "type": null,
        "status": "ready",
        "created_at": "2025-12-13T20:01:13.571488+03:30"
    }
]

2. ایجاد پایگاه دانش جدید​

برای ساخت پایگاه دانش فقط ارسال name الزامی است.

مسیر سرویس​

POST /api/v1/b2b/b2b/knowledge-bases/

بدنه درخواست (Body)​

فیلدنوعاجباریتوضیح
nameرشتهبلهنام پایگاه دانش

نمونه فراخوانی​

curl --location 'http://app.houshyar24.ir/api/v1/b2b/knowledge-bases/' --header 'Authorization: Token <your-token>' --header 'Content-Type: application/json' --data '{
  "name": "My Knowledge Base"
}'

پاسخ موفق (201)​

{
    "id": 100,
    "name": "My Knowledge Base",
    "description": null,
    "total_documents": 0,
    "total_available_documents": 0,
    "type": null,
    "status": "ready",
    "config": {
        "max_tokens": 4000,
        "chunk_overlap": 500,
        "separator": "\\n\\n\\n\\n"
    },
    "created_at": "2025-12-13T20:01:13.571488+03:30",
    "updated_at": "2025-12-13T20:01:13.571499+03:30"
}

3. دریافت جزئیات یک پایگاه دانش​

مسیر سرویس​

GET /api/v1/b2b/knowledge-bases/{kb_id}/

نمونه فراخوانی​

curl --location 'http://app.houshyar24.ir/api/v1/b2b/knowledge-bases/100/' --header 'Authorization: Token <your-token>'

4. ویرایش Knowledge Base​

مسیر سرویس​

PUT /api/v1/b2b/knowledge-bases/{kb_id}/

بدنه درخواست​

{
  "name": "Updated Knowledge Base Name"
}

6. حذف Knowledge Base​

مسیر سرویس​

DELETE /api/v1/b2b/knowledge-bases/{kb_id}/

نمونه فراخوانی​

curl --location --request DELETE 'http://app.houshyar24.ir/api/v1/b2b/knowledge-bases/100/' --header 'Authorization: Token <your-token>'

جمع‌بندی جریان کار​

  1. ایجاد پایگاه دانش
  2. آپلود فایل یا ارسال درخواست Crawl
  3. استفاده از پایگاه دانش در Agentها