fix: deploy knowledge items via data-plane instead of ARM connectors - #290
Merged
Dalibor Kovacevic (RobiladK) merged 1 commit intoAug 10, 2026
Merged
Conversation
Knowledge items (KnowledgeFile/KnowledgeText/KnowledgeWebPage) were being
deployed via ARM PUT to /connectors/{name}, causing them to appear on the
general Connectors page with stuck 'Connecting' status.
Changes:
- apply-extras.sh/ps1: PUT knowledge items to data-plane
/api/v2/extendedAgent/connectors/{name} with type 'KnowledgeItem'
instead of ARM arm_put_connector (fixes portal display)
- assemble-agent.sh/ps1: exclude KnowledgeFile from extras connectors
array (only Mcp connectors go there now)
- export-agent.sh/ps1: preserve knowledge items as-is (don't convert
KnowledgeText to .md AgentMemory uploads) so they round-trip correctly
through the Knowledge Sources path
Result: knowledge items appear under Knowledge Sources, are RAG-indexed,
and don't pollute the Connectors page.
Deepthi Chelupati (dm-chelupati)
force-pushed
the
fix/knowledge-items-dataplane-path
branch
from
August 9, 2026 23:59
22a4f8b to
123c2d7
Compare
Dalibor Kovacevic (RobiladK)
approved these changes
Aug 10, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Changes
1. Knowledge items: ARM → data-plane deployment path
Knowledge items (KnowledgeFile/KnowledgeText/KnowledgeWebPage) were deployed via ARM
PUT /connectors/{name}, causing them to appear on the Connectors page with stuck "Connecting" status instead of Knowledge Sources.Fix: PUT to data-plane
/api/v2/extendedAgent/connectors/{name}withtype: "KnowledgeItem".2. Assemble: .md files routed to knowledgeItems (not AgentMemory)
.mdfiles indata/,data/knowledge/, anddata/session-insights/were going into theknowledgearray (AgentMemory upload). Now they go intoknowledgeItems(data-plane connector PUT) so they appear under Knowledge Sources.Also removed
KnowledgeFilefrom the extrasconnectorsarray (was causing double-deploy as ARM connector).3. Export: preserve knowledge items as-is
Stopped converting KnowledgeText items to
.mdfiles for AgentMemory re-upload. They are now preserved with fullpropertiesfor round-trip via the connector PUT path.4. Session insights: export + deploy support
GET /api/v1/threads/insights→ writes todata/session-insights/*.md+.yamldata/session-insights/*.mdauto-discovered by assemble → deployed as knowledge items (no write API exists for session insights, so they transfer as searchable knowledge)Files changed (all sh + ps1 pairs)
Testing
Supersedes #283.