Skip to content

Commit 79c2efb

Browse files
author
ajosh0504
committed
Initial changes
1 parent 165d20e commit 79c2efb

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

50 files changed

+266
-1009
lines changed

‎docs/10-intro.mdx

-14
This file was deleted.

‎docs/10-mongodb-atlas/1-create-account.mdx

+40
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
import Link from "@site/src/components/Link";
2+
import Screenshot from "@site/src/components/Screenshot";
3+
4+
# 👐 Create your account
5+
6+
In this lab, you will learn how to use MongoDB Atlas as a knowledge base as well as a memory provider for AI agents.
7+
8+
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.**
9+
10+
## Sign up for MongoDB Atlas
11+
12+
Start by going to the <Link to="http://mongodb.com/try">MongoDB website</Link> and creating your account.
13+
14+
:::tip
15+
Creating a MongoDB Atlas account is free and does not require a credit card.
16+
:::
17+
18+
You will be greeted by a form similar to the one below.
19+
20+
<Screenshot url="https://cloud.mongodb.com" src="img/screenshots/10-mongodb-atlas/1-create-account/1-form.png" alt="Account creation form" />
21+
22+
:::info
23+
If you are doing this lab at an event, you should use the same email address you used to register for the event.
24+
:::
25+
26+
Complete the form and click the **Create Your Atlas Account** button.
27+
28+
## Verify your email address
29+
30+
You will receive an email from MongoDB asking you to verify your email address. Click the link in the email to verify your email address.
31+
32+
<Screenshot url="https://cloud.mongodb.com" src="img/screenshots/10-mongodb-atlas/1-create-account/2-verify-email.png" alt="Verify your email address" />
33+
34+
:::caution
35+
If you haven't received the email within two minutes, check your spam folder.
36+
:::
37+
38+
## Finish the onboarding
39+
40+
You will be redirected to the MongoDB Atlas onboarding wizard. Fill in the form and click **Finish** to continue.

‎docs/10-mongodb-atlas/2-create-cluster.mdx

+60
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
import Link from "@site/src/components/Link";
2+
import Screenshot from "@site/src/components/Screenshot";
3+
4+
# 👐 Deploy a database cluster
5+
6+
Now that you have a MongoDB Atlas account, you can create your first cluster for free.
7+
8+
Once logged in, from the overview page, click on the green button that says **+ Create**.
9+
10+
<Screenshot url="https://cloud.mongodb.com" src="img/screenshots/10-mongodb-atlas/2-create-cluster/1-overview.png" alt="Overview screenshot" />
11+
12+
:::note
13+
If you just created your account, you will automatically be redirected to the cluster creation page and can skip this step.
14+
:::
15+
16+
On the cluster creation page, choose the cloud provider and region where your data will be stored. You can also choose the type of cluster you want to create. For this lab, we will use the free tier.
17+
18+
1. For the cluster tier, pick **M0**, which is the free tier. In the **Name** input box, assign a name (one word, no spaces) to your cluster.
19+
1. Uncheck the *Automate security setup* box. You will set up security manually in the next steps.
20+
1. Uncheck the *Preload sample dataset* box. You will import a dataset later in this lab.
21+
1. Select your favorite cloud provider and the region closest to you.
22+
1. Finally, click on the green button that says **Create Deployment**.
23+
24+
<Screenshot url="https://cloud.mongodb.com" src="img/screenshots/10-mongodb-atlas/2-create-cluster/2-deploy-database.png" alt="Create cluster screenshot" />
25+
26+
Once you're done with the hardest part of the process (the captcha), you will be redirected to the security quickstart.
27+
28+
## Security quickstart
29+
30+
By default, your MongoDB Atlas deployment is completely locked-down. You need to configure the network settings and create a user to access your database.
31+
32+
While your deployment is being provisioned, you will see the security quickstart dialog.
33+
34+
### Network access
35+
36+
First, you should **Allow Access from Anywhere**. You will see a field prepolulated with the IP address `0.0.0.0/0`. This means that you can connect to your database from any IP address including the virtual environment you will use for this lab. Click **Add IP Address** to add this IP address to the network allowlist.
37+
38+
:::caution
39+
It is dangerous to expose your database to the entire world. Never do this is a real production environment.
40+
:::
41+
42+
### Database user
43+
44+
Next, you need to create a database user. Pick any username and password you want. This will be used when you want to connect to your database. Click **Create Database User** to create the user.
45+
46+
Atlas might create the user automatically for you if you have just created your account. In this case, the username and password will match your Atlas account credentials.
47+
48+
:::tip
49+
Make sure to remember your username and password. You will need them later. For the sake of this workshop, it might be preferable to use a simple password that you'll remember over a more secure one.
50+
:::
51+
52+
## Manual network access configuration
53+
54+
If you don't see a button to **Allow Access from Anywhere**, you should close the dialog and go to the **Network Access** tab under the **Security** section in the left sidebar. Click on the **Add IP Address** button, add the IP address `0.0.0.0/0` and click **Confirm**.
55+
56+
## That's all!
57+
58+
That's all! You have a new database cluster. If everything goes well, you should see your newly created cluster in the database deployment screen.
59+
60+
<Screenshot url="https://cloud.mongodb.com" src="img/screenshots/10-mongodb-atlas/2-create-cluster/3-database-deployment.png" alt="Screenshot of the database deployment screen" />

‎docs/10-mongodb-atlas/3-get-connection-string.mdx

+30
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
import Link from "@site/src/components/Link";
2+
import Screenshot from "@site/src/components/Screenshot";
3+
4+
# 👐 Get your connection string
5+
6+
In order to ingest data into your cluster later in the lab, you will need to get the connection string for your cluster.
7+
8+
In the Atlas UI, navigate to the **Overview** page. In the **Clusters section**, selct the tab for the cluster you just created and click **Connect**.
9+
10+
<Screenshot url="https://cloud.mongodb.com" src="img/screenshots/10-mongodb-atlas/3-get-conn-string/1-connect-button.png" alt="Screenshot of the connect button" />
11+
12+
A modal will display several ways to connect to your database.
13+
14+
<Screenshot url="https://cloud.mongodb.com" src="img/screenshots/10-mongodb-atlas/3-get-conn-string/2-connect-modal.png" alt="Screenshot of the connect modal" />
15+
16+
Select **Compass**. While we won't be using Compass to import the data, it's an easy way to see your connection string.
17+
18+
<Screenshot url="https://cloud.mongodb.com" src="img/screenshots/10-mongodb-atlas/3-get-conn-string/3-connect-compass.png" alt="Screenshot of the connection string" />
19+
20+
Look for your connection string. It should look something like:
21+
22+
```
23+
mongodb+srv://<username>:<password>@<cluster-url>/
24+
```
25+
26+
Click the copy button next to your connection string to copy it to your clipboard. Paste the connection string somewhere safe.
27+
28+
:::tip
29+
Don't forget to replace `<password>` with the password you set when you created the cluster.
30+
:::

‎docs/10-mongodb-atlas/_category_.json

+8
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
{
2+
"label": "MongoDB Atlas",
3+
"position": 1,
4+
"link": {
5+
"type": "generated-index",
6+
"description": "Create a MongoDB Atlas account and deploy a free cluster."
7+
}
8+
}

‎docs/20-docusaurus.mdx

-25
This file was deleted.

‎docs/20-fireworks-ai/1-create-account.mdx

+15
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
import Screenshot from "@site/src/components/Screenshot";
2+
3+
# 👐 Create an account
4+
5+
In this lab, we will be using _FireFunction V1_, a free and open-source function calling model from Fireworks AI.
6+
7+
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 move on to the next section.**
8+
9+
Start by navigating to to the [Fireworks AI homepage](https://fireworks.ai/) and click the purple **Get Started Free** button to create an account.
10+
11+
<Screenshot url="https://fireworks.ai/" src="img/screenshots/20-fireworks-ai/1-create-account/1-homepage.png" alt="Get started" />
12+
13+
Click **Login With Google** and authenticate with your Google account. This will provision a new Fireworks account for you.
14+
15+
<Screenshot url="https://fireworks.ai/" src="img/screenshots/20-fireworks-ai/1-create-account/2-google-login.png" alt="Login" />

‎docs/20-fireworks-ai/2-create-api-key.mdx

+17
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
import Screenshot from "@site/src/components/Screenshot";
2+
3+
# 👐 Create an API Key
4+
5+
Once you have a Fireworks account, you can create an API key.
6+
7+
Upon logging in, click the **API Keys** tab.
8+
9+
<Screenshot url="https://fireworks.ai/" src="img/screenshots/20-fireworks-ai/2-create-api-key/1-api-key.png" alt="Select API keys" />
10+
11+
Click the purple **Create API Key** button. In the modal that appears, enter a name and click **Create Key** to create an API key.
12+
13+
<Screenshot url="https://fireworks.ai/" src="img/screenshots/20-fireworks-ai/2-create-api-key/2-create-api-key.png" alt="Create API key" />
14+
15+
Click the copy button next to your API key to copy it to your clipboard. Paste the API key somewhere safe.
16+
17+
<Screenshot url="https://fireworks.ai/" src="img/screenshots/20-fireworks-ai/2-create-api-key/3-copy-api-key.png" alt="Copy API key" />

‎docs/20-fireworks-ai/_category_.json

+8
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
{
2+
"label": "Fireworks AI",
3+
"position": 2,
4+
"link": {
5+
"type": "generated-index",
6+
"description": "Create a Fireworks AI account and API key."
7+
}
8+
}

‎docs/30-dev-env/1-dev-setup.mdx

+41
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
import Screenshot from "@site/src/components/Screenshot";
2+
3+
# 👐 Setup Dev Environment
4+
5+
* Clone the [GitHub repo](https://github.com/mongodb-developer/ai-agents-lab-notebooks.git) for this lab by executing the following command from the terminal:
6+
7+
```
8+
git clone https://github.com/mongodb-developer/ai-agents-lab-notebooks.git
9+
```
10+
11+
* `cd` into the cloned directory:
12+
13+
```
14+
cd ai-agents-lab-notebooks
15+
```
16+
17+
* Create and activate a Python virtual environment:
18+
19+
```
20+
python -m venv mongodb-ai-agents-lab
21+
source mongodb-ai-agents-lab/bin/activate
22+
```
23+
24+
* Install and launch Jupyter Notebook:
25+
26+
```
27+
pip install notebook
28+
jupyter notebook
29+
```
30+
31+
* In the browser tab that pops up, open the notebook named `notebook_template.ipynb`. This is the notebook you will be working in for this lab.
32+
33+
<Screenshot url="localhost:8888/tree" src="img/screenshots/30-dev-env/1-jupyter-notebook.png" alt="Jupyter Notebook" />
34+
35+
* Run the code cell under `Step 1: Install Libraries` in the notebook to install all the Python libraries required for the lab.
36+
37+
<Screenshot url="http://localhost:8888/notebooks/notebook_template.ipynb" src="img/screenshots/30-dev-env/2-install-libraries.png" alt="Install libraries" />
38+
39+
* Under `Step 2: Setup Pre-requisites`, replace `<CODE_BLOCK_1>` with the MongoDB connection string, `<CODE_BLOCK_2>` with the Fireworks API key and run the cells.
40+
41+
<Screenshot url="http://localhost:8888/notebooks/notebook_template.ipynb" src="img/screenshots/30-dev-env/3-setup-prereqs.png" alt="Setup prereqs" />

‎docs/30-dev-env/_category_.json

+8
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
{
2+
"label": "Dev Environment",
3+
"position": 3,
4+
"link": {
5+
"type": "generated-index",
6+
"description": "In this section, you will set up the Python development environment for this lab."
7+
}
8+
}

‎docs/30-quick-start.mdx

-45
This file was deleted.

0 commit comments

Comments
 (0)