More screenshots

mongodb-developer · Nov 18, 2024 · 08b33a5 · 08b33a5
1 parent fb41b92
commit 08b33a5
Show file tree

Hide file tree

Showing 27 changed files with 113 additions and 42 deletions.
diff --git a/docs/20-mongodb-atlas/1-create-account.mdx b/docs/20-mongodb-atlas/1-create-account.mdx
@@ -5,7 +5,29 @@ import Screenshot from "@site/src/components/Screenshot";
 
 In this lab, you will learn how to use MongoDB Atlas as a knowledge base as well as a memory provider for RAG applications.
 
-To use MongoDB Atlas, you will need to start by creating an account. **If you already have an account, you can skip the following steps and move on to the next section.**
+To use MongoDB Atlas, you will need to start by creating an account.
+
+<details>
+  <summary>🦹 If you already have an Atlas account, you can use it by creating a new project</summary>
+
+    First, log into <Link to="https://account.mongodb.com/">MongoDB Atlas</Link> using your existing credentials.
+
+    <Screenshot url="https://account.mongodb.com" src={"img/screenshots/20-mongodb-atlas/1-create-account/3-login.png"} alt="Login form" />
+
+    ## Create a new Atlas project
+
+    Once you're in Atlas, open the dropdown on the left-top corner of the page and select **New Project**.
+
+    <Screenshot url="https://cloud.mongodb.com" src={"img/screenshots/20-mongodb-atlas/1-create-account/4-new-project.png"} alt="Create new project" />
+
+    Enter a name for your project and click **Next**.
+
+    <Screenshot url="https://cloud.mongodb.com" src={"img/screenshots/20-mongodb-atlas/1-create-account/5-new-project-name.png"} alt="Create new project" />
+
+    On the next page, you can leave the current user as the project owner, and click **Create Project**.
+
+    Once the project is ready, continue the workshop from <a href="./create-cluster">**deploying a Database Cluster**</a>
+</details>
 
 ## Sign up for MongoDB Atlas
 

diff --git a/docs/30-fireworks-ai/1-create-account.mdx b/docs/30-fireworks-ai/1-create-account.mdx
@@ -2,14 +2,16 @@ import Screenshot from "@site/src/components/Screenshot";
 
 # 👐 Create an account
 
-In this lab, we will use the _Llama 3 8B Instruct_ model hosted by Fireworks AI. Fireworks gives you $1 credit upon sign up which is plenty to experiment with industry-leading models on their platform.
+In this lab, we will use the _Llama 3 8B Instruct_ model hosted by Fireworks AI.
 
-The easiest way to use the model is via the Fireworks API. But first, you will need to create a Fireworks account. **If you already have an account, you can skip the following steps and move on to the next section.**
+The easiest way to use this model is via the Fireworks API. But first, you will need to create a Fireworks account.
+
+If you already have an account, you can skip the following steps and continue the workshop from <a href="./create-api-key">**create an API key**</a>
 
 Start by navigating to the [Fireworks AI homepage](https://fireworks.ai/) and click the purple **Get Started Free** button to create an account.
 
 <Screenshot url="https://fireworks.ai/" src="img/screenshots/30-fireworks-ai/1-create-account/1-homepage.png" alt="Get started" />
 
-Click **Login With Google** and authenticate with your Google account. This will provision a new Fireworks account for you.
+Click **Login With Google** and authenticate with your Google account.
 
 <Screenshot url="https://fireworks.ai/" src="img/screenshots/30-fireworks-ai/1-create-account/2-google-login.png" alt="Login" />
diff --git a/docs/30-fireworks-ai/2-create-api-key.mdx b/docs/30-fireworks-ai/2-create-api-key.mdx
@@ -2,14 +2,12 @@ import Screenshot from "@site/src/components/Screenshot";
 
 # 👐 Create an API key
 
-To use the Fireworks API, you will need an API Key. To create a secure API key, follow the steps below.
+Once logged in, navigate to **API keys** under **User Settings**.
 
-Upon logging in, click the **User** tab.
+<Screenshot url="https://fireworks.ai/" src="img/screenshots/30-fireworks-ai/2-create-api-key/1-api-keys.png" alt="Select API keys" />
 
-<Screenshot url="https://fireworks.ai/" src="img/screenshots/30-fireworks-ai/2-create-api-key/1-api-key.png" alt="Select API keys" />
-
-Click the purple **Create API Key** button. In the modal that appears, enter a name and click **Create Key** to create an API key.
+Click the **Create API Key** button to create a Secure API Key.
 
 <Screenshot url="https://fireworks.ai/" src="img/screenshots/30-fireworks-ai/2-create-api-key/2-create-api-key.png" alt="Create API key" />
 
-When prompted, copy the API key to a safe location.
+In the modal that appears, follow the steps to create an API key and when prompted, copy and paste it somewhere safe.
diff --git a/docs/50-prepare-the-data/1-jupyter-notebooks.mdx b/docs/50-prepare-the-data/1-jupyter-notebooks.mdx
@@ -0,0 +1,31 @@
+# 📘 Running Jupyter Notebooks in Google Colab
+
+Jupyter Notebooks is an interactive Python environment. Cells in a Jupyter notebook are a modular unit of code or text that you can execute and view outputs for.
+
+In this lab, we will use Colaboratory (a.k.a Colab) which is a hosted Jupyter Notebook service from Google.
+
+To run a cell in Colab, hover over it and click the Run icon that appears against the cell.
+
+<Screenshot url="https://us-west-2.console.aws.amazon.com/sagemaker/jupyter" src="img/screenshots/50-prepare-the-data/1-jupyter-notebooks/1-run-cell.png" alt="Run a cell" />
+
+When a cell is running, you will see a loading spinner appear against the cell. 
+
+<Screenshot url="https://us-west-2.console.aws.amazon.com/sagemaker/jupyter" src="img/screenshots/50-prepare-the-data/1-jupyter-notebooks/2-running-cell.png" alt="A running cell" />
+
+When a cell is finished running successfully, you will see green check mark appear against the cell.
+
+<Screenshot url="https://us-west-2.console.aws.amazon.com/sagemaker/jupyter" src="img/screenshots/50-prepare-the-data/1-jupyter-notebooks/3-successful-cell.png" alt="Successful cell run" />
+
+If an error occurred while running a cell, you will see an error traceback after the cell.
+
+<Screenshot url="https://us-west-2.console.aws.amazon.com/sagemaker/jupyter" src="img/screenshots/50-prepare-the-data/1-jupyter-notebooks/4-error-in-cell.png" alt="Erroneous cell run" />
+
+To fix errors, you may need to update previous cells. If you do, re-run all the cells following the one(s) you updated.
+
+To interrupt a running cell, click the Stop icon that you see against the cell while it is running.
+
+<Screenshot url="https://us-west-2.console.aws.amazon.com/sagemaker/jupyter" src="img/screenshots/50-prepare-the-data/1-jupyter-notebooks/5-interrupt-cell.png" alt="Interrupt cell run" />
+
+:::warning
+The UI might differ slightly if you are running Jupyter Notebooks outside of Google Colab. Refer to the appropriate documentation if running the notebook using a different service.    
+:::
diff --git a/docs/50-prepare-the-data/1-load-data.mdx → docs/50-prepare-the-data/2-load-data.mdx b/docs/50-prepare-the-data/1-load-data.mdx → docs/50-prepare-the-data/2-load-data.mdx
diff --git a/docs/50-prepare-the-data/2-chunk-data.mdx → docs/50-prepare-the-data/3-chunk-data.mdx b/docs/50-prepare-the-data/2-chunk-data.mdx → docs/50-prepare-the-data/3-chunk-data.mdx
diff --git a/docs/50-prepare-the-data/3-embed-data.mdx → docs/50-prepare-the-data/4-embed-data.mdx b/docs/50-prepare-the-data/3-embed-data.mdx → docs/50-prepare-the-data/4-embed-data.mdx
diff --git a/docs/50-prepare-the-data/4-ingest-data.mdx b/docs/50-prepare-the-data/4-ingest-data.mdx
diff --git a/docs/50-prepare-the-data/5-ingest-data.mdx b/docs/50-prepare-the-data/5-ingest-data.mdx
@@ -0,0 +1,41 @@
+import Screenshot from "@site/src/components/Screenshot";
+
+# 👐 Ingest data into MongoDB
+
+The final step to build a MongoDB vector store for our RAG application is to ingest the embedded article chunks into MongoDB.
+
+Fill in any `<CODE_BLOCK_N>` placeholders and run the cells under the **Step 6: Ingest data into MongoDB** section in the notebook to ingest the embedded documents into MongoDB.
+
+The answers for code blocks in this section are as follows:
+
+**CODE_BLOCK_6**
+
+<details>
+<summary>Answer</summary>
+<div>
+```python
+mongodb_client[DB_NAME][COLLECTION_NAME]
+```
+</div>
+</details>
+
+**CODE_BLOCK_7**
+
+<details>
+<summary>Answer</summary>
+<div>
+```python
+collection.insert_many(embedded_docs)
+```
+</div>
+</details>
+
+To verify that the data has been imported into your MongoDB cluster, navigate to the **Overview** page in the Atlas UI. In the **Clusters section**, select your cluster and click **Browse collections**.
+
+<Screenshot url="https://cloud.mongodb.com" src="img/screenshots/50-agent-tools/3-import-data/1-browse-collections.png" alt="Browse collections" />
+
+Ensure that you see a database called _mongodb_agents_lab_, and two collections namely _chunked_articles_ and _full_articles_ under it. Note the number and format of documents in both the collections.
+
+<Screenshot url="https://cloud.mongodb.com" src="img/screenshots/50-agent-tools/3-import-data/2-chunked-collection.png" alt="Chunked collection" />
+
+<Screenshot url="https://cloud.mongodb.com" src="img/screenshots/50-agent-tools/3-import-data/3-full-collection.png" alt="Full collection" />
diff --git a/docs/60-perform-semantic-search/2-create-vector-index.mdx b/docs/60-perform-semantic-search/2-create-vector-index.mdx
@@ -15,4 +15,12 @@ The answers for code blocks in this section are as follows:
 collection.create_search_index(model=model)
 ```
 </div>
-</details>
+</details>
+
+To verify that the index was created, navigate to **Search Indexes** for the _knowledge_base_ collection.
+
+<Screenshot url="https://cloud.mongodb.com" src="img/screenshots/60-perform-semantic-search/2-create-vector-index/1-nav-search-indexes.png" alt="Navigate to search indexes" />
+
+The index is ready to use once the status changes from **PENDING** to **READY**.
+
+<Screenshot url="https://cloud.mongodb.com" src="img/screenshots/60-perform-semantic-search/2-create-vector-index/2-index-ready.png" alt="Index ready to use" />
diff --git a/static/img/screenshots/20-mongodb-atlas/1-create-account/3-login.png b/static/img/screenshots/20-mongodb-atlas/1-create-account/3-login.png
diff --git a/static/img/screenshots/20-mongodb-atlas/1-create-account/4-new-project.png b/static/img/screenshots/20-mongodb-atlas/1-create-account/4-new-project.png
diff --git a/static/img/screenshots/20-mongodb-atlas/1-create-account/5-new-project-name.png b/static/img/screenshots/20-mongodb-atlas/1-create-account/5-new-project-name.png
diff --git a/static/img/screenshots/30-fireworks-ai/1-create-account/1-homepage.png b/static/img/screenshots/30-fireworks-ai/1-create-account/1-homepage.png
diff --git a/static/img/screenshots/30-fireworks-ai/1-create-account/2-google-login.png b/static/img/screenshots/30-fireworks-ai/1-create-account/2-google-login.png
diff --git a/static/img/screenshots/30-fireworks-ai/2-create-api-key/1-api-key.png b/static/img/screenshots/30-fireworks-ai/2-create-api-key/1-api-key.png
diff --git a/static/img/screenshots/30-fireworks-ai/2-create-api-key/1-api-keys.png b/static/img/screenshots/30-fireworks-ai/2-create-api-key/1-api-keys.png
diff --git a/static/img/screenshots/30-fireworks-ai/2-create-api-key/2-create-api-key.png b/static/img/screenshots/30-fireworks-ai/2-create-api-key/2-create-api-key.png
diff --git a/static/img/screenshots/50-prepare-the-data/1-jupyter-notebooks/1-run-cell.png b/static/img/screenshots/50-prepare-the-data/1-jupyter-notebooks/1-run-cell.png
diff --git a/static/img/screenshots/50-prepare-the-data/1-jupyter-notebooks/2-running-cell.png b/static/img/screenshots/50-prepare-the-data/1-jupyter-notebooks/2-running-cell.png
diff --git a/...c/img/screenshots/50-prepare-the-data/1-jupyter-notebooks/3-successful-cell.png b/...c/img/screenshots/50-prepare-the-data/1-jupyter-notebooks/3-successful-cell.png
diff --git a/static/img/screenshots/50-prepare-the-data/1-jupyter-notebooks/4-error-in-cell.png b/static/img/screenshots/50-prepare-the-data/1-jupyter-notebooks/4-error-in-cell.png
diff --git a/...ic/img/screenshots/50-prepare-the-data/1-jupyter-notebooks/5-interrupt-cell.png b/...ic/img/screenshots/50-prepare-the-data/1-jupyter-notebooks/5-interrupt-cell.png
diff --git a/static/img/screenshots/50-prepare-the-data/5-ingest-data/1-browse-collections.png b/static/img/screenshots/50-prepare-the-data/5-ingest-data/1-browse-collections.png
diff --git a/static/img/screenshots/50-prepare-the-data/5-ingest-data/2-verify-collection.png b/static/img/screenshots/50-prepare-the-data/5-ingest-data/2-verify-collection.png
diff --git a/...shots/60-perform-semantic-search/2-create-vector-index/1-nav-search-indexes.png b/...shots/60-perform-semantic-search/2-create-vector-index/1-nav-search-indexes.png
diff --git a/.../screenshots/60-perform-semantic-search/2-create-vector-index/2-index-ready.png b/.../screenshots/60-perform-semantic-search/2-create-vector-index/2-index-ready.png