Skip to content
Merged
Changes from all 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
20 changes: 10 additions & 10 deletions assistant.qmd
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ A few examples of these integration points include Positron's:
- Variables pane, providing names, dimensions, and column names of dataframes and Python/R based database connections, as well as metadata for arrays, lists, and other objects in memory
- Plots pane for describing the current plot or suggesting variations and next steps for iterating on the current plot
- Console, available to the model for viewing inputs and code outputs, as well as allowing the user or an AI agent to execute code in the console and view the output
- Session state, proving what language is active in the console session (R or Python, including version), what packages are loaded, and what packages are installed
- Session state, providing what language is active in the console session (R or Python, including version), what packages are loaded, and what packages are installed

All of that Positron-specific context is in addition to the core capabilities of what traditional software-oriented GenAI clients have (active files, selected lines of code, files in project, training data in the model, etc).

Expand All @@ -41,13 +41,17 @@ The general steps to use Positron Assistant are:

## Enabling Positron Assistant

Positron Assistant is not enabled by default. Follow these steps to enable it:
Positron Assistant is not enabled by default.

- ["Positron > Assistant: Enable"](positron://settings/positron.assistant.enable): Clicking this link will enable the Positron Assistant feature in Positron.

Alternatively, you can enable Positron Assistant in the user settings UI:

1. Run the command `Preferences: Open User Settings (UI)` in the Command Palette to open user settings

1. Search for the setting `positron.assistant.enable` and check the box for ["Positron > Assistant: Enable"](positron://settings/positron.assistant.enable)
1. Search for the setting `positron.assistant.enable` and check the box for [

1. Restart Positron or run the `Developer: Reload Window` command in the Command Palette.
1. Restart Positron or run the _Developer: Reload Window_ command in the Command Palette.

1. Positron Assistant is now enabled!

Expand Down Expand Up @@ -76,10 +80,6 @@ Anthropic and GitHub Copilot are the currently supported language model provider

1. Click the "Done" button once you have added all the desired model providers. You can always come back to this dialog later to add or remove providers.

::: {.callout-tip}
1. Run the _Positron Assistant: Add Language Model_ command to open the language model provider dialog. You can also click the "Add Language Model provider" button in the Positron Assistant chat area (note: the button may be collapsed within the `...` context menu).
:::

#### Removing language model providers

1. Run the _Positron Assistant: Add Language Model_ command to open the language model dialog. You can also click the "Add Language Model" button in the Positron Assistant chat area (note: the button may be collapsed within the `...` context menu).
Expand Down Expand Up @@ -111,14 +111,14 @@ Chat participants provide specialized knowledge to the Positron Assistant. You c

### Inline chat

The command `Inline Chat: Editor Inline Chat` (default keybinding: <kbd>Cmd + I</kbd>) will open a mini chat right in the editor. This is very useful for asking questions in context, and also includes a good UX for integrating changes suggested by the model.
The command _Inline Chat: Editor Inline Chat_ (default keybinding: <kbd>Cmd</kbd> + <kbd>I</kbd>) will open a mini chat right in the editor. This is very useful for asking questions in context, and also includes a good UX for integrating changes suggested by the model.

### Completions

If GitHub Copilot is enabled and the user pauses typing for a few seconds, Positron Assistant will offer completions in most contexts. If it is not working, check the following:

- Make sure you have a [language model provider added](#adding-language-model-providers) for completions.
- Check the [developer tools console logs](troubleshooting.qmd#developer-tools) to see if there are any errors logged. Run the `Developer: Toggle Developer Tools` command in the Command Palette to open DevTools.
- Check the [developer tools console logs](troubleshooting.qmd#developer-tools) to see if there are any errors logged.

## Shiny Assistant

Expand Down