تخطَّ إلى المستندات
API

عرض عناصر المعرفة

عناصر قاعدة المعرفة، الأحدث أولًا، صفحة في كل مرة.

GET/knowledge

ينفّذ الاستدعاء الحقيقي على مساحة عملك.

GET /knowledge

عناصر قاعدة المعرفة، الأحدث أولًا، صفحة في كل مرة.

مثال

يتطلب knowledge:read. كل مرشّح اختياري: يُبقي scope مستوى واحدًا، وlevel نوعًا واحدًا من المستويات (workspace أو domain أو address)، وkind الملاحظات أو الملفات أو الروابط، وstatus حالة واحدة، وpinned الملاحظات المثبّتة، ويطابق q كلمات في العنوان أو اسم الملف أو الرابط. يصل limit إلى 100 وقيمته الافتراضية 50، ويأخذ cursor قيمة nextCursor من الصفحة السابقة.

curl
curl "$OE/knowledge?level=domain&limit=20" -H "$AUTH"
الاستجابة
{  "object": "list",  "data": [{      "object": "knowledge_item",      "id": "kb_8c1f4a2b9d7e3f60a5c7b21d",      "kind": "note",      "scope": "@acme.com",      "level": "domain",      "title": "Refunds",      "url": null,      "fileName": null,      "mimeType": null,      "sizeBytes": null,      "pinned": true,      "status": "ready",      "failure": null,      "chunks": 1,      "chars": 71,      "origin": "api",      "createdBy": "usr_5f2a9c71",      "createdAt": "2026-10-08T09:12:44.000Z",      "updatedAt": "2026-10-08T09:12:44.000Z",      "indexedAt": "2026-10-08T09:12:45.000Z"    }],  "hasMore": false,  "nextCursor": null}

يرى المفتاح أو التطبيق المقصور على عناوين معيّنة عناصر مساحة العمل كلها وعناصر عناوينه ونطاقاتها. والمستوى الذي لا يستطيع رؤيته لا يعرض شيئًا.

المؤشر الذي لم تسلّمه هذه القائمة هو 400 invalid_cursor.

المرجع