First application content

Author: codingbandit

05_Create_First_Cosmos_DB_Project/README.md

@@ -1,18 +1,61 @@
-# Create your first Cosmos DB project (console app (Jupyter notebook?))
+# Create your first Cosmos DB project
 
-- How to use the Cosmos DB SDK
-- How to develop locally
+In this section, we'll cover how to create your first Cosmos DB project. We'll use a notebook to demonstrate the basic CRUD operations. We'll also cover how to use the Azure Cosmos DB Emulator to test your code locally.
 
-## Emulator support (does it support vector search?)
-## Authentication options
-## Create a database
-## Create a collection
-## Create a document
+## Emulator support
 
-## INCLUDE 08_Load_Data here
+Azure Cosmos DB has an emulator that you can use to develop your code locally. The emulator supports the API for NoSQL and API for MongoDB. Usage of the emulator does not require an Azure Subscription nor does it incur any costs so is ideal for local development and testing. The Azure Cosmos DB emulator can also be utilized with unit tests in a [GitHub Actions CI workflow](https://learn.microsoft.com/en-us/azure/cosmos-db/how-to-develop-emulator?tabs=windows%2Cpython&pivots=api-mongodb#use-the-emulator-in-a-github-actions-ci-workflow).
 
-## Read a document
-## Update a document
-## Delete a document
-## Query documents
+There is not 100% feature parity between the emulator and the cloud service. Visit the [Azure Cosmos DB emulator](https://learn.microsoft.com/en-us/azure/cosmos-db/emulator) documentation for more details.
 
+For Windows machines, the emulator can be installed via an installer. There is a Windows container using Docker available, however it does not currently support the API for Mongo DB. A Docker image is also available for Linux that does support the API for Mongo DB.
+
+Learn more about the pre-requisites and installation of the emulator [here](https://learn.microsoft.com/en-us/azure/cosmos-db/how-to-develop-emulator?tabs=windows%2Cpython&pivots=api-mongodb).
+
+## Authentication
+
+Authentication to Azure Cosmos DB API for Mongo DB is done using a connection string. The connection string is a URL that contains the authentication information for your Azure Cosmos DB account or local emulator. The username and password used when provisioning the Azure Cosmos DB API for MongoDB service are used in the connection string when authenticating to Azure.
+
+### Retrieving the connection string from the Cosmos DB Emulator
+
+The splash screen or **Quickstart** section of the Cosmos DB Emulator will display the connection string. Access this screen through the following URL: `https://localhost:8081/_explorer/index.html`.
+
+![The Azure Cosmos DB emulator screen displays with the local host url, the Quickstart tab, and the Mongo connection string highlighted.](media/emulator_connection_string.png)
+
+### Retrieving the connection string from the Azure portal
+
+Retrieve the connection string from the Azure portal by navigating to your Azure Cosmos DB account and selecting the **Connection String** menu item on the left-hand side of the screen. The connection string contains tokens for the username an password that must be replaced with the username and password used when provisioning the Azure Cosmos DB API for MongoDB service. Additional users can be added at any time using the [Azure CLI](https://learn.microsoft.com/en-us/cli/azure/cosmosdb/mongodb/user?view=azure-cli-latest).
+
+![The Azure CosmosDb API for MongoDB Connection strings screen displays with the copy button next to the connection string highlighted.](media/azure_connection_string.png)
+
+## Authorization
+
+Azure Cosmos DB API for MongoDB supports fine-grained role-based access control (RBAC) for authorization. There are a number of built-in roles available. The built-in roles are:
+    1. read
+    2. readWrite
+    3. dbAdmin
+    4. dbOwner
+
+The ability to create custom roles is also available. Custom roles can be created using the [Azure CLI](https://learn.microsoft.com/en-us/azure/cosmos-db/mongodb/how-to-setup-rbac). Custom roles can include granular permissions for specific databases, collections, and operational actions. Learn more about the [Azure CLI RBAC commands to define custom roles](https://learn.microsoft.com/en-us/azure/cosmos-db/mongodb/how-to-setup-rbac#azure-cli-rbac-commands).
+
+## Helpful tools
+
+Visualization and querying tools:
+    1. Studio 3T
+    2. MongoDB Compass
+    3. Azure Data Studio
+    4. MongoDB Shell
+    5. Azure Portal Data Explorer
+
+## Lab 1 - Create your first Cosmos DB for MongoDB application
+
+In this lab, we'll create a Cosmos DB for MongoDB application using a notebook. You have the choice to either use the Azure Cosmos DB Emulator or an Azure Cosmos DB account in Azure. The following concepts will be covered in this lab:
+    1. Create a database
+    2. Create a collection
+    3. Create a document
+    4. Read a document
+    5. Update a document
+    6. Delete a document
+    7. Query documents
+
+Please visit the lab repository to complete this lab.

05_Create_First_Cosmos_DB_Project/media/azure_connection_string.png

@@ -15,6 +15,7 @@ A prompt is an input or instruction provided to an Artificial Intelligence (AI)
 Prompt engineering is the iterative process of designing, evaluating, and optimizing prompts to produce consistently accurate responses from language models for a particular problem domain. It involves designing and refining the prompts given to an AI model to achieve the desired outputs. Prompt engineers experiment with various prompts, test their effectiveness, and refine them to improve performance. Performance is measured using predefined metrics such as accuracy, relevance, and user satisfaction to assess the impact of prompt engineering.
 
 ## General anatomy of a prompt
+
 Instruction, context, input, output indicator
 
 ## Zero-shot prompting