Eine Notiz hinzufügen
Eine Notiz von bis zu 20.000 Zeichen auf einer Ebene, meist innerhalb von ein, zwei Sekunden bereit.
Führt den echten Aufruf in Ihrem Workspace aus.
POST /knowledge/notes
Eine Notiz von bis zu 20.000 Zeichen auf einer Ebene, meist innerhalb von ein, zwei Sekunden bereit.
Beispiel
Erfordert knowledge:write. title hat bis zu 200 Zeichen und body bis zu 20.000, gern in Markdown. Lassen Sie scope für den ganzen Workspace weg. pinned legt die Notiz in jeden Prompt auf ihrer Ebene, bis zu 2.000 Zeichen angehefteter Notizen von jeder Ebene. Antwortet 201 mit der Notiz.
curl -X POST "$OE/knowledge/notes" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "scope": "@acme.com", "title": "Refunds", "body": "Refunds are paid within 14 days of the return reaching our warehouse.", "pinned": true }'{ "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"}Einen Eintrag zu ändern erfordert Zugriff auf jede Adresse, die seine Ebene abdeckt: Der ganze Workspace erfordert jede Adresse, eine Domain die ganze Domain und eine Adresse diese Adresse. Ein Schlüssel oder eine App, die auf bestimmte Adressen beschränkt ist, kann Einträge nur auf diesen Adressen ändern oder auf Domains, die sie ganz hält.
Eine Ebene, die weder der Workspace noch eine seiner Domains noch eine seiner Adressen ist, ist ein 422 invalid_knowledge_scope, und eine außerhalb dessen, was der Schlüssel erreicht, ein 403 knowledge_scope_not_reached. Dieselbe Anfrage zweimal zu senden fügt zwei Notizen hinzu.