Skip to content

Commit d002370

Browse files
authored
Merge pull request #8 from mongodb-developer/cloud-agnostic-updates
Making workshop cloud agnostic and merging GenAI lab notebooks
2 parents 8e7c1a6 + eef0d26 commit d002370

23 files changed

+29
-152
lines changed

docs/20-mongodb-atlas/1-create-account.mdx

Lines changed: 0 additions & 62 deletions
This file was deleted.

docs/20-mongodb-atlas/1-setup.mdx

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
# 👐 MongoDB Setup
2+
3+
:::caution
4+
If you are doing this lab as part of a MongoDB GenAI Developer Day, at this point you should already have a free cluster, so you can skip this step.
5+
:::
6+
7+
In this lab, you will learn how to use MongoDB Atlas as a knowledge base as well as a memory provider for a RAG-based documentation chatbot.
8+
9+
To use MongoDB Atlas, you will need to create an account, a free cluster and obtain the connection string to connect to your cluster. Follow these steps to get set up:
10+
11+
* [Register for a free MongoDB Atlas account](https://mongodb-developer.github.io/intro-lab/docs/mongodb-atlas/create-account)
12+
13+
* [Create a new database cluster](https://mongodb-developer.github.io/intro-lab/docs/mongodb-atlas/create-cluster)
14+
15+
* [Obtain the connection string for your database cluster](https://mongodb-developer.github.io/intro-lab/docs/importing-data/get-connection-string)

docs/20-mongodb-atlas/2-create-cluster.mdx

Lines changed: 0 additions & 56 deletions
This file was deleted.

docs/20-mongodb-atlas/3-get-connection-string.mdx

Lines changed: 0 additions & 24 deletions
This file was deleted.

docs/30-dev-env/2-dev-setup.mdx

Lines changed: 14 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2,29 +2,33 @@ import Screenshot from "@site/src/components/Screenshot";
22

33
# 👐 Setup dev environment
44

5+
:::caution
6+
If you are doing this lab as part of a MongoDB GenAI Developer Day, at this point you should already have the GitHub Codespace ready for this lab, so you can skip this step.
7+
:::
8+
59
## Option 1: GitHub Codespaces
610

711
You will be working in a Jupyter Notebook in a GitHub Codespace throughout this lab. A codespace is a cloud-hosted, containerized development environment that comes pre-configured with all the tools you need to run this lab.
812

9-
Navigate to [this](https://github.com/codespaces/new/mongodb-developer/ai-rag-lab-notebooks?quickstart=1) link. You will be prompted to sign into GitHub if you haven't already. Once signed in, click the **Create new codespace** button to create a new codespace.
13+
Navigate to [this](https://github.com/codespaces/new/mongodb-developer/genai-devday-notebooks?quickstart=1) link. You will be prompted to sign into GitHub if you haven't already. Once signed in, click the **Create new codespace** button to create a new codespace.
1014

1115
<Screenshot url="https://github.com/codespaces" src="img/screenshots/30-dev-env/2-dev-setup/1-create-codespace.png" alt="Start a codespace" />
1216

13-
Let it run for a few seconds as it prepares your environment. It will clone the repository, prepare the container, and run the installation scripts.
17+
Let it run for a few seconds as it prepares your environment. It will clone the repository, prepare the container, and run the installation scripts. Once the environment is built, you should see a list of files appear under the Explorer.
1418

15-
In the left navigation bar of the IDE, click on the file named `notebook_template.ipynb` to open the Jupyter Notebook for the lab.
19+
In the left navigation bar of the IDE, click on the file named `ai-rag-lab.ipynb` to open the Jupyter Notebook for this lab.
1620

1721
<Screenshot url="https://github.com/codespaces" src="img/screenshots/30-dev-env/2-dev-setup/2-nav-notebook.png" alt="Navigate to the notebook" />
1822

1923
Next, select the Python interpreter by clicking **Select Kernel** at the top right of the IDE.
2024

2125
<Screenshot url="https://github.com/codespaces" src="img/screenshots/30-dev-env/2-dev-setup/3-select-kernel.png" alt="Select kernel" />
2226

23-
In the modal that appears, click **Python environments...** and select the recommended interpreter.
27+
In the modal that appears, click **Python environments...** and select the interpreter that is marked as **Recommended** or **Global Env**.
2428

25-
<Screenshot url="https://github.com/codespaces" src="img/screenshots/30-dev-env/2-dev-setup/4-python-env-modal.png" alt="Select recommended interpreter" />
29+
<Screenshot url="https://github.com/codespaces" src="img/screenshots/30-dev-env/2-dev-setup/4-python-env-modal.png" alt="Select Python Environments" />
2630

27-
<Screenshot url="https://github.com/codespaces" src="img/screenshots/30-dev-env/2-dev-setup/5-select-default.png" alt="Select recommended interpreter" />
31+
<Screenshot url="https://github.com/codespaces" src="img/screenshots/30-dev-env/2-dev-setup/5-select-recommended.png" alt="Select recommended interpreter" />
2832

2933
That's it! You're ready for the lab!
3034

@@ -36,16 +40,16 @@ During the lab, we will use GitHub Codespaces. These instructions are here just
3640

3741
If you want to run the notebook locally, follow the steps below:
3842

39-
* Clone the [GitHub repo](https://github.com/mongodb-developer/ai-rag-lab-notebooks.git) for this lab by executing the following command from the terminal:
43+
* Clone the [GitHub repo](https://github.com/mongodb-developer/genai-devday-notebooks.git) for this lab by executing the following command from the terminal:
4044

4145
```
42-
git clone https://github.com/mongodb-developer/ai-rag-lab-notebooks.git
46+
git clone https://github.com/mongodb-developer/genai-devday-notebooks.git
4347
```
4448

4549
* `cd` into the cloned directory:
4650

4751
```
48-
cd ai-rag-lab-notebooks
52+
cd genai-devday-notebooks
4953
```
5054

5155
* Create and activate a Python virtual environment:
@@ -62,6 +66,6 @@ pip install notebook
6266
jupyter notebook
6367
```
6468

65-
* In the browser tab that pops up, open the file named `notebook_template.ipynb`.
69+
* In the browser tab that pops up, open the file named `ai-rag-lab.ipynb`.
6670

6771
<Screenshot url="localhost:8888/tree" src="img/screenshots/30-dev-env/2-dev-setup/6-jupyter-notebook.png" alt="Jupyter Notebook" />
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Loading
Loading
Loading
Loading
Binary file not shown.
Loading
Loading

0 commit comments

Comments
 (0)