Skip to content

Migrate vector store docs from Microsoft.SemanticKernel.Connectors.* to CommunityToolkit.VectorData.*#54993

Merged
adamsitnik merged 3 commits into
mainfrom
copilot/update-vector-store-docs-and-code
Jul 22, 2026
Merged

Migrate vector store docs from Microsoft.SemanticKernel.Connectors.* to CommunityToolkit.VectorData.*#54993
adamsitnik merged 3 commits into
mainfrom
copilot/update-vector-store-docs-and-code

Conversation

Copilot AI commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Migrates all docs/ai/vector-stores documentation and snippets from the deprecated Microsoft.SemanticKernel.Connectors.* packages to CommunityToolkit.VectorData.*, and updates VectorStoreVectorAttribute usage to reflect that Dimensions is now a mandatory constructor argument (dimensions:) rather than a settable property.

Docs

  • overview.md: Updated using import, package links, and [VectorStoreVector(Dimensions:)] example. Removed the now-invalid [!NOTE] explaining why "SemanticKernel" appeared in package names.
  • define-your-data-model.md: Updated all inline code examples and the parameter table — Dimensions property xref replaced with dimensions constructor argument entry.
  • manage-data.md, vector-search.md: Fixed Dimensions:dimensions: in data model examples.
  • how-to/use-vector-stores.md: Updated install command and removed SK disclaimer.
  • how-to/build-vector-search-app.md: Updated package names and descriptions in both OpenAI and Azure OpenAI pivots.
  • how-to/vector-store-data-ingestion.md: Updated Redis provider link.

Snippets

-using Microsoft.SemanticKernel.Connectors.InMemory;
+using CommunityToolkit.VectorData.InMemory;

-[VectorStoreVector(Dimensions: 384, DistanceFunction = DistanceFunction.CosineSimilarity)]
+[VectorStoreVector(dimensions: 384, DistanceFunction = DistanceFunction.CosineSimilarity)]
  • All using Microsoft.SemanticKernel.Connectors.* imports replaced with CommunityToolkit.VectorData.* equivalents (InMemory, Qdrant, Redis).
  • All .csproj package references updated to CommunityToolkit.VectorData.* v1.0.0 / 1.*.

Internal previews

📄 File 🔗 Preview link
docs/ai/vector-stores/define-your-data-model.md docs/ai/vector-stores/define-your-data-model
docs/ai/vector-stores/how-to/build-vector-search-app.md docs/ai/vector-stores/how-to/build-vector-search-app
docs/ai/vector-stores/how-to/use-vector-stores.md docs/ai/vector-stores/how-to/use-vector-stores
docs/ai/vector-stores/how-to/vector-store-data-ingestion.md docs/ai/vector-stores/how-to/vector-store-data-ingestion
docs/ai/vector-stores/manage-data.md docs/ai/vector-stores/manage-data
docs/ai/vector-stores/overview.md docs/ai/vector-stores/overview

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because there is no eligible user to bill. To allow Copilot reviews on bot-authored pull requests, enable direct organization billing in your organization's Copilot settings.

@adamsitnik adamsitnik left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@copilot address my feedback

Comment thread docs/ai/vector-stores/how-to/build-vector-search-app.md Outdated
Comment thread docs/ai/vector-stores/how-to/use-vector-stores.md Outdated
Comment thread docs/ai/vector-stores/how-to/vector-store-data-ingestion.md Outdated
Comment thread docs/ai/vector-stores/snippets/conceptual/VectorStoreSnippets.csproj Outdated
Comment thread docs/ai/vector-stores/snippets/conceptual/VectorStoreSnippets.csproj Outdated
Comment thread docs/ai/vector-stores/snippets/how-to/HowToSnippets.csproj Outdated

Copilot AI commented Jul 22, 2026

Copy link
Copy Markdown
Contributor Author

@copilot address my feedback

Addressed all feedback in the latest commit:

  • Removed --prerelease from all three install command examples (build-vector-search-app.md, use-vector-stores.md, vector-store-data-ingestion.md)
  • Pinned CommunityToolkit.VectorData.* package versions to 1.0.0 in both .csproj files
  • Removed the explicit Qdrant.Client reference from VectorStoreSnippets.csproj (it's a transitive dependency of CommunityToolkit.VectorData.Qdrant)

Copilot AI requested a review from adamsitnik July 22, 2026 13:44

@adamsitnik adamsitnik left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@copilot address my feedback

Comment thread docs/ai/vector-stores/how-to/use-vector-stores.md Outdated
Copilot AI requested a review from adamsitnik July 22, 2026 13:50
@adamsitnik
adamsitnik marked this pull request as ready for review July 22, 2026 13:51
@adamsitnik
adamsitnik requested review from a team and gewarren as code owners July 22, 2026 13:51
@adamsitnik
adamsitnik requested a review from roji July 22, 2026 13:51

@adamsitnik adamsitnik left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@adamsitnik
adamsitnik enabled auto-merge (squash) July 22, 2026 13:55
```

For production scenarios, replace `Microsoft.SemanticKernel.Connectors.InMemory` with the provider for your database. For available providers, see [Out-of-the-box Vector Store providers](/semantic-kernel/concepts/vector-store-connectors/out-of-the-box-connectors/). (Despite the inclusion of "SemanticKernel" in the provider package names, these providers have nothing to do with Semantic Kernel and are usable anywhere in .NET, including Agent Framework.)
For production scenarios, replace `CommunityToolkit.VectorData.InMemory` with the provider for your database. For available providers, see [Out-of-the-box Vector Store providers](/semantic-kernel/concepts/vector-store-connectors/out-of-the-box-connectors/).

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should/can we replace the link?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am trying to get this particular document updated in MicrosoftDocs/semantic-kernel-docs#429, but I agree that in the long term we should provide our own list (it would not contain python-specific or deprecated connectors)

@adamsitnik
adamsitnik merged commit dd17663 into main Jul 22, 2026
11 checks passed
@adamsitnik
adamsitnik deleted the copilot/update-vector-store-docs-and-code branch July 22, 2026 16:12
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.

4 participants