پرش به مستندات
API

افزودن پیوند

یک صفحهٔ وب عمومی که در پس‌زمینه گرفته و خوانده می‌شود.

POST/knowledge/links

فراخوانی واقعی را روی فضای کاری شما اجرا می‌کند.

POST /knowledge/links

یک صفحهٔ وب عمومی که در پس‌زمینه گرفته و خوانده می‌شود.

نمونه

به knowledge:write نیاز دارد. url یک نشانی عمومی http یا https با حداکثر 2,048 نویسه است که به‌صورت https نگه داشته می‌شود. بدون title، مورد تا خوانده‌شدن صفحه نام پیوند را دارد و پس از آن عنوان خود صفحه را. با پیوند، در وضعیت queued، 201 برمی‌گرداند.

curl
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 است.

صفحه‌ای که گرفته نشود با failure: "fetch_failed" در وضعیت failed تمام می‌شود. از هر صفحه حداکثر 5 MB خوانده می‌شود.

مرجع