Skip to content

fix: deploy knowledge items via data-plane instead of ARM connectors - #290

Merged
Dalibor Kovacevic (RobiladK) merged 1 commit into
mainfrom
fix/knowledge-items-dataplane-path
Aug 10, 2026
Merged

fix: deploy knowledge items via data-plane instead of ARM connectors#290
Dalibor Kovacevic (RobiladK) merged 1 commit into
mainfrom
fix/knowledge-items-dataplane-path

Conversation

@dm-chelupati

@dm-chelupati Deepthi Chelupati (dm-chelupati) commented Aug 9, 2026

Copy link
Copy Markdown
Collaborator

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} with type: "KnowledgeItem".

2. Assemble: .md files routed to knowledgeItems (not AgentMemory)

.md files in data/, data/knowledge/, and data/session-insights/ were going into the knowledge array (AgentMemory upload). Now they go into knowledgeItems (data-plane connector PUT) so they appear under Knowledge Sources.

Also removed KnowledgeFile from the extras connectors array (was causing double-deploy as ARM connector).

3. Export: preserve knowledge items as-is

Stopped converting KnowledgeText items to .md files for AgentMemory re-upload. They are now preserved with full properties for round-trip via the connector PUT path.

4. Session insights: export + deploy support

  • Export: reads from GET /api/v1/threads/insights → writes to data/session-insights/*.md + .yaml
  • Deploy/Clone: data/session-insights/*.md auto-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)

Script .sh .ps1
export-agent
apply-extras
assemble-agent

Testing

  • All 6 scripts pass syntax validation
  • Tested new-agent + deploy with knowledge files → deployed as KnowledgeItem connectors, indexed in Knowledge Sources
  • Tested export on demo1-dt-snow → session insights exported, knowledge items metadata captured
  • Assemble routes .md files → knowledge: 0, items: 2

Supersedes #283.

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.
@dm-chelupati
Deepthi Chelupati (dm-chelupati) force-pushed the fix/knowledge-items-dataplane-path branch from 22a4f8b to 123c2d7 Compare August 9, 2026 23:59
@RobiladK
Dalibor Kovacevic (RobiladK) merged commit 0f9eeda into main Aug 10, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants