You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+6Lines changed: 6 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -35,6 +35,12 @@ npm run watch
35
35
36
36
2. Inside of [VS Code Insiders](https://code.visualstudio.com/insiders/) open this directory and press `F5` to begin debugging the extension. This should launch a new VSCode window which is running the extension.
37
37
38
+
### Using Proposed API
39
+
40
+
The vscode extension will occasionally need to use [proposed API](https://code.visualstudio.com/api/advanced-topics/using-proposed-api) that haven't been promoted to stable yet. To enable an API proposal, add it to the `enabledApiProposals` section in `package.json`, then run `cd src/vscode-dts && npx @vscode/dts dev` to install the type definitions for the API you want to enable.
41
+
42
+
**Note**: Using proposed API is only possible during local development and will prevent publishing the extension.
Use natural language to interact with your clusters and generate MongoDB-related code with GitHub Copilot Chat in VS Code.
83
+
84
+
_Note: To use the MongoDB Participant, you must have the [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) extension. By using Copilot Chat you agree to [GitHub Copilot chat preview terms](https://docs.github.com/en/copilot/responsible-use-of-github-copilot-features/responsible-use-of-github-copilot-chat-in-your-ide). Find more details about the MongoDB GenAI Features in the [FAQ](https://www.mongodb.com/docs/generative-ai-faq/)._
85
+
86
+
#### How to use the MongoDB Participant
87
+
88
+
1. Enter `@MongoDB` in the chat input field to start a conversation with the MongoDB Participant.
-`/docs` is a participant command that finds answers to coding-related questions in the [MongoDB documentation](https://www.mongodb.com/docs/).
97
+
-`/query` is a participant command that generates MongoDB queries from natural language to be used with a connected MongoDB cluster. It generates both queries and aggregations depending on the complexity of the request. It utilizes schema to reduce model hallucinations. It provides a code action to open generated code in a playground and an action to directly run the code from the Copilot chat interface.
98
+
-`/schema` is a participant command that analyzes and returns information about a collection's schema.
80
99
81
100
## Extension Settings
82
101
@@ -88,6 +107,8 @@ Connect to Atlas Stream Processing instances and develop stream processors using
88
107
|`mdb.showMongoDBHelpExplorer`| Show or hide the MongoDB Help panel. |`true`|
89
108
|`mdb.defaultLimit`| The number of documents to fetch when viewing documents from a collection. |`10`|
90
109
|`mdb.confirmRunAll`| Show a confirmation message before running commands in a playground. |`true`|
110
+
|`mdb.confirmRunCopilotCode`| Show a confirmation message before running code generated by the MongoDB participant. |`true`|
111
+
|`mdb.useSampleDocsInCopilot`| Enable sending sample field values with the VSCode copilot chat @MongoDB participant /query command. |`false`|
91
112
|`mdb.confirmDeleteDocument`| Show a confirmation message before deleting a document in the tree view. |`true`|
92
113
|`mdb.persistOIDCTokens`| Remain logged in when using the MONGODB-OIDC authentication mechanism for MongoDB server connection. Access tokens are encrypted using the system keychain before being stored. |`true`|
93
114
|`mdb.showOIDCDeviceAuthFlow`| Opt-in and opt-out for diagnostic and telemetry collection. |`true`|
@@ -97,6 +118,8 @@ Connect to Atlas Stream Processing instances and develop stream processors using
97
118
|`mdb.useDefaultTemplateForPlayground`| Choose whether to use the default template for playground files or to start with an empty playground editor. |`true`|
98
119
|`mdb.uniqueObjectIdPerCursor`| The default behavior is to generate a single ObjectId and insert it on all cursors. Set to true to generate a unique ObjectId per cursor instead. |`false`|
99
120
|`mdb.sendTelemetry`| Opt-in and opt-out for diagnostic and telemetry collection. |`true`|
121
+
|`mdb.confirmRunCopilotCode`| Show a confirmation message before running code generated by the MongoDB participant. |`true`|
122
+
|`mdb.useSampleDocsInCopilot`| Enable sending sample field values with the VSCode copilot chat @MongoDB participant /query command. |`false`|
0 commit comments