API
إضافة رابط
صفحة ويب عامة تُجلب وتُقرأ في الخلفية.
POST/knowledge/links
ينفّذ الاستدعاء الحقيقي على مساحة عملك.
POST /knowledge/links
صفحة ويب عامة تُجلب وتُقرأ في الخلفية.
مثال
يتطلب knowledge:write. url عنوان http أو https عام لا يتجاوز 2,048 حرفًا، ويُحفظ بصيغة https. ومن دون title يحمل العنصر اسم الرابط حتى تُقرأ الصفحة، ثم عنوان الصفحة نفسها. يجيب بـ201 مع الرابط، queued.
curl -X POST "$OE/knowledge/links" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "url": "https://acme.com/shipping" }'{ "object": "knowledge_item", "id": "kb_3e7b1d9a4c2f80e6b5a1c47d", "kind": "link", "scope": "", "level": "workspace", "title": "https://acme.com/shipping", "url": "https://acme.com/shipping", "fileName": null, "mimeType": null, "sizeBytes": null, "pinned": false, "status": "queued", "failure": null, "chunks": 0, "chars": 0, "origin": "api", "createdBy": "usr_5f2a9c71", "createdAt": "2026-10-08T09:14:02.000Z", "updatedAt": "2026-10-08T09:14:02.000Z", "indexedAt": null}العنوان على مضيف خاص أو محلي، أو الذي يتضمن اسم مستخدم أو كلمة مرور أو منفذًا، هو 422 invalid_knowledge_url. والرابط نفسه في المستوى نفسه هو 409 knowledge_link_exists.
الصفحة التي يتعذّر جلبها تنتهي failed مع failure: "fetch_failed". ولا يُقرأ من الصفحة أكثر من 5 MB.