Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: update README with information about the participant VSCODE-587 #841

Merged
merged 8 commits into from
Sep 27, 2024
Merged
Show file tree
Hide file tree
Changes from 3 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -77,6 +77,25 @@ Connect to Atlas Stream Processing instances and develop stream processors using

![Atlas Stream Processing Playground](resources/screenshots/atlas-stream-processing.png)

### MongoDB Copilot Participant

Use a natural language to interact with your clusters and generate MongoDB-related code through GitHub Copilot Chat in VS Code.
alenakhineika marked this conversation as resolved.
Show resolved Hide resolved

_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/)._

#### How to use the MongoDB Participant

1. Enter `@MongoDB` in the chat input field to start a conversation with the MongoDB Participant.

![MongoDB Participant](resources/screenshots/mongodb-participant.png)

2. Start typing `/` in the chat window to get the list of available chat participant commands.

![MongoDB Participant Commands](resources/screenshots/mongodb-participant-commands.png)

- `/docs` is a participant command, which finds answers to coding-related questions in the [MongoDB documentation](https://www.mongodb.com/docs/).
alenakhineika marked this conversation as resolved.
Show resolved Hide resolved
- `/query` is a participant command, which generates queries from a natural language against a connected MongoDB cluster. It generates both queries and aggregation depending on the complexity of the request. It utilizes schema to reduce model hallucinations. It providing code actions to either open the query in a playground or directly run the query from the Copilot chat interface.
alenakhineika marked this conversation as resolved.
Show resolved Hide resolved
- `/schema` is a participant command, which analyzes and returns information about a collection's schema.
alenakhineika marked this conversation as resolved.
Show resolved Hide resolved
alenakhineika marked this conversation as resolved.
Show resolved Hide resolved

## Extension Settings

Expand All @@ -99,6 +118,8 @@ Connect to Atlas Stream Processing instances and develop stream processors using
| `mdb.useDefaultTemplateForPlayground` | Choose whether to use the default template for playground files or to start with an empty playground editor. | `true` |
| `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` |
| `mdb.sendTelemetry` | Opt-in and opt-out for diagnostic and telemetry collection. | `true` |
| `mdb.confirmRunCopilotCode` | Show a confirmation message before running code generated by the MongoDB participant. | `true` |
| `mdb.useSampleDocsInCopilot` | Enable sending sample field values with the VSCode copilot chat @MongoDB participant /query command. | `false` |

## Additional Settings

Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added resources/screenshots/mongodb-participant.png
alenakhineika marked this conversation as resolved.
Show resolved Hide resolved
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading