Datacoves Copilot v2 config.

Author: Sebastian Sassi

docs/_sidebar.md

@@ -11,7 +11,7 @@
   - [Snowflake Extension](/getting-started/developer/snowflake-extension.md)
   - [Transform Tab](/getting-started/developer/transform-tab.md)
   - [Working with dbt in Datacoves](/getting-started/developer/working-with-dbt-datacoves.md)
-    - [Lineage View](/getting-started/developer/lineage-view.md) 
+    - [Lineage View](/getting-started/developer/lineage-view.md)
   - [Using Git](/getting-started/developer/using-git.md)
 - **Diving Deeper**
 - [How to](/how-tos/)
@@ -87,8 +87,11 @@
     - [Add a Dataset](/how-tos/superset/how_to_data_set.md)
   - [VS Code](/how-tos/vscode/)
     - [Datacoves Copilot](/how-tos/vscode/datacoves-copilot/)
-      - [Config](/how-tos/vscode/datacoves-copilot/llm-config.md)
-      - [Usage](/how-tos/vscode/datacoves-copilot/llm.md)
+      - [V1](/how-tos/vscode/datacoves-copilot/v1.md)
+        - [Config](/how-tos/vscode/datacoves-copilot/v1-llm-config.md)
+        - [Usage](/how-tos/vscode/datacoves-copilot/v1-llm.md)
+      - [V2](/how-tos/vscode/datacoves-copilot/v2.md)
+        - [Config](/how-tos/vscode/datacoves-copilot/v2-llm-config.md)
     - [Initial Configuration](/how-tos/vscode/initial.md)
       - [BigQuery](/how-tos/vscode/bigquery_setup.md)
       - [Databricks](/how-tos/vscode/databricks_setup.md)

docs/how-tos/vscode/datacoves-copilot/README.md

@@ -1,12 +1,19 @@
 # AI LLMs for Datacoves Copilot
-Datacoves can integrate seamlessly with your existing ChatGPT or Azure Open AI LLMs. These how tos will go over configuration and usage of AI within Datacoves.
+
+Datacoves can integrate seamlessly with your existing LLMs. These how tos will go over configuration and usage of AI within Datacoves.
 
 ### Prereqs
+
 - Have an existing LLM such as ChatGPT or [Azure Open AI](https://learn.microsoft.com/en-us/azure/ai-services/openai/assistants-quickstart?tabs=command-line%2Ckeyless%2Ctypescript-keyless&pivots=ai-foundry-portal)
 - Have access to API and Endpoint url credentials.
 - Have `Admin` access to configure credentials in Datacoves
 
 ## How to's
 
-- [LLM Config](/how-tos/vscode/datacoves-copilot/llm-config.md)
-- [Working with an LLM in Datacoves](/how-tos/vscode/datacoves-copilot/llm.md)
+### Datacoves Copilot v2
+
+- [Datacoves Copilot v2](/how-tos/vscode/datacoves-copilot/v2.md)
+
+### Datacoves Copilot v1 (Deprecated)
+
+- [Datacoves Copilot v1](/how-tos/vscode/datacoves-copilot/v1.md)

docs/how-tos/vscode/datacoves-copilot/assets/v2_llm_example.png

@@ -1,18 +1,18 @@
-# Configure your LLM in Datacoves
+# Configure your LLM for Datacoves Copilot v1
 
->[!NOTE] We currently only support the 4o model gpt model.
+> [!NOTE] Datacoves Copilot v1 only support the 4o model gpt model.
 
 ### Step 1: Create a Datacoves Secret
 
-Creating a [Datacoves Secret](/how-tos/datacoves/how_to_secrets.md) requires some key fields to be filled out: 
+Creating a [Datacoves Secret](/how-tos/datacoves/how_to_secrets.md) requires some key fields to be filled out:
 
 - **Name:** The secret must be named `datacoves-copilot-llm-api`
 - **Description:** Provide a simple description such as: `Open AI config`
-- **Format:** Select `Raw JSON`  
+- **Format:** Select `Raw JSON`
 - **Value**: The value will vary based on the LLM you are utilizing.
   - **Open AI:** You only need your API key. Head to [Open AI](https://platform.openai.com/api-keys) to create your key. `{"OPENAI_API_KEY": "Your key here"}`
   - **Azure Open AI:** This requires two credentials. Head to [ai.azure.com](https://ai.azure.com) to find your credentials under the [Deployments](https://learn.microsoft.com/en-us/azure/ai-services/openai/how-to/working-with-models?tabs=powershell#model-deployment-upgrade-configuration) tab. `{"AZURE_OPENAI_ENDPOINT": "Your endpoint here", "AZURE_OPENAI_API_KEY"  : "Your key here"}`
-- **Scope:** Select the desired scope, either `Project` or `Environment`. 
+- **Scope:** Select the desired scope, either `Project` or `Environment`.
 - **Project/Environment:** Select the `Project` or `Environment` that will access this LLM.
 
 Lastly, be sure to toggle on the `Share with developers` option so that users with developer access will be able to use the LLM.
@@ -21,4 +21,3 @@ Lastly, be sure to toggle on the `Share with developers` option so that users wi
 ### Example Secret
 
 ![Example ](assets/llm_example.png)
-

docs/how-tos/vscode/datacoves-copilot/llm-config.md renamed to docs/how-tos/vscode/datacoves-copilot/v1-llm-config.md

@@ -1,66 +1,74 @@
-# Working with an LLM in Datacoves Copilot
+# Working with an LLM in Datacoves Copilot v1
 
-Once you have [configured your LLM](/how-tos/vscode/datacoves-copilot/llm-config.md), working with the AI chat is a breeze! 
+Once you have [configured your LLM](/how-tos/vscode/datacoves-copilot/v1-llm-config.md), working with the AI chat is a breeze!
 
 ## Pre-configured presets
 
-While there are many use cases for AI in the development workflow there are a couple of tasks that come up regularly. To improve the user experience, we have created some presets that provide the LLM with specific instructions to get the best result. Use these or configure your own custom presets. 
+While there are many use cases for AI in the development workflow there are a couple of tasks that come up regularly. To improve the user experience, we have created some presets that provide the LLM with specific instructions to get the best result. Use these or configure your own custom presets.
 
 Current out of the box presents include:
 
 - **Document dbt model:** Will provide descriptions for yml file you have open and provided as context.
 - **Explain dbt model:** Will explain a dbt model file you have open and provided as context.
 - **Explain dbt macro:** Will explain a dbt macro file you have open and provided as context.
-- **Add descriptions to CSV:** Will provide descriptions for CSV files you have open and provided as context. 
+- **Add descriptions to CSV:** Will provide descriptions for CSV files you have open and provided as context.
 
 ## How to use the Chat/Presets
 
 ### Extension UI/UX
 
-To use your LLM head to the Datacoves Power User extension and open up `Copilot`. 
+To use your LLM head to the Datacoves Power User extension and open up `Copilot`.
 
 <img src="/how-tos/vscode/datacoves-copilot/assets/llm_menu.png" alt="LLM Menu" width="250" height="500">
 
-### Provide files for context 
+### Provide files for context
+
 The most important thing to remember is providing context to the LLM. In order to do this simply open up the file you wish to work with.
 
 ![llm file open](assets/llm_file_open.png)
 
 ### Send specific lines of code for context
+
 Highlight the lines of code you wish to send.
 
 ![context lines](assets/llm_line_context.png)
 
 ### Don't provide context
+
 In the case that you don't want to send an open file for context you can select the icon below.
 
 ![llm context](assets/llm_context.gif)
 
-## Using LLM code 
-Datacoves Copilot makes copying AI generated code simple with 3 options. 
+## Using LLM code
+
+Datacoves Copilot makes copying AI generated code simple with 3 options.
 
 ![Code Options](assets/llm_code_options.png)
 
 ### Replace
+
 Replace the entire code file with the LLM code.
 
 ![llm Replace](assets/llm_replace.gif)
 
-### Insert 
+### Insert
+
 Insert LLM code into your file.
 
 ![llm Insert](assets/llm_insert.gif)
 
 ### Copy
-Traditional copy and paste. 
+
+Traditional copy and paste.
 
 ![llm Copy](assets/llm_copy.gif)
 
 ### New Chat
+
 To start a new chat click on the `New Chat` button.
 
 ![New Chat](assets/llm_new_chat.png)
 
 ## Prefer a Video?
 
-<div style="position: relative; padding-bottom: 56.25%; height: 0;"><iframe src="https://www.loom.com/embed/b6e987152c114c3c8d44dc7712aa3e22?sid=d8847855-38cc-4a84-90b3-6be7e660f8b5" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></iframe></div>
+<div style="position: relative; padding-bottom: 56.25%; height: 0;"><iframe src="https://www.loom.com/embed/b6e987152c114c3c8d44dc7712aa3e22?sid=d8847855-38cc-4a84-90b3-6be7e660f8b5" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></iframe></div>

docs/how-tos/vscode/datacoves-copilot/llm.md renamed to docs/how-tos/vscode/datacoves-copilot/v1-llm.md

@@ -0,0 +1,10 @@
+# Datacoves Copilot v1
+
+This section describes how to configure and use Datacoves Copilot v1.
+
+Datacoves Copilot v1 supports ChatGPT and Azure Open AI LLMs, Datacoves v4+ includes Datacoves Copilot 2.0 which enhances the experience and supports many more LLM providers.
+
+# How Tos
+
+- [LLM Config](/how-tos/vscode/datacoves-copilot/v1-llm-config.md)
+- [Working with an LLM in Datacoves](/how-tos/vscode/datacoves-copilot/v1-llm.md)