Skip to content

docs: document chatAgents, languageModelChatProviders, and languageModelTools contribution points#9969

Merged
ntrogh merged 2 commits into
microsoft:mainfrom
1chooo:docs/issue-9968-undocumented-contribution-points
Jun 26, 2026
Merged

docs: document chatAgents, languageModelChatProviders, and languageModelTools contribution points#9969
ntrogh merged 2 commits into
microsoft:mainfrom
1chooo:docs/issue-9968-undocumented-contribution-points

Conversation

@1chooo

@1chooo 1chooo commented Jun 22, 2026

Copy link
Copy Markdown
Contributor

Summary

Resolved #9968. Three contribution points existed in VS Code but were missing from the Contribution Points reference page:

  • chatAgents — never documented anywhere; contributes .agent.md custom agent files from an extension
  • languageModelChatProviders — documented only in the extension guide, not the reference
  • languageModelTools — documented only in the extension guide, not the reference

Each new entry follows the established pattern used by the adjacent chatInstructions, chatSkills, and chatPromptFiles entries: a short description, a JSON example, and a properties table. The two languageModel* entries also include a cross-link back to their respective extension guides.

Changes

  • api/references/contribution-points.md
    • Added chatAgents, languageModelChatProviders, and languageModelTools to the TOC (alphabetically ordered)
    • Added ## contributes.chatAgents section (after contributes.breakpoints)
    • Added ## contributes.languageModelChatProviders section (between contributes.languages and contributes.menus)
    • Added ## contributes.languageModelTools section (after contributes.languageModelChatProviders)

Test plan

  • Verify the three new anchors resolve correctly in the rendered page
  • Confirm the TOC links scroll to the correct sections
  • Check the JSON examples and property tables for accuracy against the VS Code source

Made with Cursor

…ools contribution points

Adds three missing entries to the Contribution Points reference page:

- `chatAgents`: contributes .agent.md custom agent files from extensions
- `languageModelChatProviders`: contributes custom language model providers
- `languageModelTools`: contributes language model tools invokable by agents

Each entry includes a description, JSON example, and properties table.

Closes microsoft#9968

Co-authored-by: Cursor <cursoragent@cursor.com>

@ntrogh ntrogh left a comment

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.

@1chooo There are some inaccuracies in your PR.

Comment thread api/references/contribution-points.md Outdated
Comment thread api/references/contribution-points.md Outdated
Comment thread api/references/contribution-points.md Outdated
Comment thread api/references/contribution-points.md Outdated
Comment thread api/references/contribution-points.md
Co-authored-by: Nick Trogh <ntrogh@hotmail.com>
@ntrogh ntrogh merged commit bcc331a into microsoft:main Jun 26, 2026
1 of 3 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.

Some contribution points are not documented

3 participants