From 6ec8458781fe86d4aa8a8e5772b6454815d7f810 Mon Sep 17 00:00:00 2001 From: Claude Date: Sun, 20 Sep 2026 07:38:41 +0000 Subject: [PATCH] docs(ai): knowledge-rag example declares adapterConfig, not the undeclared options key `content/docs/ai/knowledge-rag.mdx` configured its `ragflow` knowledge source with `options: { datasetId }`. `KnowledgeSourceSchema` declares `adapterConfig` and is a plain `z.object` with no `.passthrough()`, so the key is dropped before any adapter sees it. Since #19251 (card #18973, ruling batch #160 item 2, letter A) `extractRagflowOptions` reads `source.adapterConfig` with no fallback, so a source copied from this page is refused by name at the first upsert / search / delete: RAGFlow adapter requires source.adapterConfig.datasetId on source '' One line, one page. No spec change and no ADR-0087 conversion: `options` was never a key `KnowledgeSourceSchema` accepted, so nothing an author could declare is removed. Claude-Session: https://claude.ai/code/session_017ef78bLdybu3AffehKkhfk Co-authored-by: Claude --- content/docs/ai/knowledge-rag.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/ai/knowledge-rag.mdx b/content/docs/ai/knowledge-rag.mdx index 1a35b357f83..9d74b4eed0c 100644 --- a/content/docs/ai/knowledge-rag.mdx +++ b/content/docs/ai/knowledge-rag.mdx @@ -34,7 +34,7 @@ kernel.use(new KnowledgeServicePlugin({ label: 'Product docs', adapter: 'ragflow', source: { kind: 'http', urls: ['https://docs.example.com/sitemap.xml'] }, - options: { datasetId: 'rgf_doc_dataset' }, + adapterConfig: { datasetId: 'rgf_doc_dataset' }, }, ], }));