Modernize, refine, and standardize the notebook collection

.claude/settings.json

@@ -0,0 +1,5 @@
+{
+  "enabledPlugins": {
+    "mongodb@claude-plugins-official": true
+  }
+}

.gitignore

@@ -1,3 +1,4 @@
 .ipynb_checkpoints
 **/.DS_Store
 apps/video-intelligence/frontend/public/videos/*.mp4
+.env

AGENTS.md

@@ -0,0 +1,54 @@
+# AGENTS.md
+
+Guidance for coding assistants working in this repository.
+
+## Project Structure
+
+- notebooks/: Jupyter notebook examples (agents, rag, evals)
+- apps/: application-style demos
+- workshops/: self-paced workshop content
+- partners/: partner-contributed examples
+- .github/workflows/tests.yml: CI checks via pre-commit
+
+## Build and Test Commands
+
+Repository-level checks:
+
+```bash
+python -m pip install pre-commit
+pre-commit run --all-files
+```
+
+Notebook workflow (typical):
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install -U notebook
+jupyter notebook
+```
+
+## Environment Variables and Configuration
+
+Common variables used in notebooks:
+- MONGODB_URI (or equivalent MongoDB Atlas URI variable)
+- Provider keys as required by notebook (for example OPENAI_API_KEY, ANTHROPIC_API_KEY)
+
+Always read notebook setup cells before running and export required variables in your shell/kernel.
+
+## MongoDB Skills
+
+Use the official MongoDB agent skills from https://github.com/mongodb/agent-skills whenever the task is MongoDB-specific and a matching skill exists.
+
+## When To Use EDD.md
+
+Use EDD.md as a schema source of truth when a notebook/app evolves into a larger multi-file project with stable entities and indexes.
+
+For small, self-contained notebook examples, EDD.md is optional.
+
+## appName Guidance
+
+When updating MongoDB client initialization, keep or add appName for observability.
+Accepted project formats include both:
+- hyphen style: devrel-medium-primary-secondary-optional
+- dot style: devrel.showcase.notebook.agent.example

notebooks/advanced_techniques/evaluating_information_retrival_techniques_mongondb_langchain.ipynb

@@ -6,6 +6,8 @@
         "id": "oB0TFkwoNsv7"
       },
       "source": [
+        "[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/mongodb-developer/GenAI-Showcase/blob/main/notebooks/advanced_techniques/evaluating_information_retrival_techniques_mongondb_langchain.ipynb)\n",
+        "\n",
         "# Information Retrieval Evaluation With BEIR Benchmark and LangChain and MongoDB\n",
         "\n",
         "\n",
@@ -410,6 +412,7 @@
         "    new_vector_search_index_model = SearchIndexModel(\n",
         "        definition=index_definition,\n",
         "        name=index_name,\n",
+        "        type=\"vectorSearch\",\n",
         "    )\n",
         "\n",
         "    # Create the new index\n",
@@ -420,6 +423,7 @@
         "        print(f\"New index '{index_name}' created successfully:\", result)\n",
         "    except Exception as e:\n",
         "        print(f\"Error creating new vector search index '{index_name}': {e!s}\")\n",
+        "        raise\n",
         "\n",
         "\n",
         "def create_collection_search_index(collection, index_definition, index_name):\n",
@@ -485,17 +489,15 @@
       "outputs": [],
       "source": [
         "corpus_vector_search_index_definition = {\n",
-        "    \"mappings\": {\n",
-        "        \"dynamic\": True,\n",
-        "        \"fields\": {\n",
-        "            \"embedding\": {\n",
-        "                \"dimensions\": 256,\n",
-        "                \"similarity\": \"cosine\",\n",
-        "                \"type\": \"knnVector\",\n",
-        "            },\n",
-        "        },\n",
-        "    }\n",
-        "}"
+        "    \"fields\": [\n",
+        "        {\n",
+        "            \"type\": \"vector\",\n",
+        "            \"path\": \"embedding\",\n",
+        "            \"numDimensions\": 256,\n",
+        "            \"similarity\": \"cosine\",\n",
+        "        }\n",
+        "    ]\n",
+        "}\n"
       ]
     },
     {

notebooks/advanced_techniques/instruction_following_reranking.ipynb

@@ -5,7 +5,7 @@
       "id": "24e92416",
       "metadata": {},
       "source": [
-        "[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/mongodb-developer/GenAI-Showcase/blob/main/notebooks/advanced_techniques/instruction-following-reranking.ipynb)\n",
+        "[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/mongodb-developer/GenAI-Showcase/blob/main/notebooks/advanced_techniques/instruction_following_reranking.ipynb)\n",
         "\n",
         "[![View Article](https://img.shields.io/badge/View%20Article-blue)](https://www.mongodb.com/developer/products/atlas/parent-doc-retrieval/?utm_campaign=devrel&utm_source=cross-post&utm_medium=organic_social&utm_content=https%3A%2F%2Fgithub.com%2Fmongodb-developer%2FGenAI-Showcase&utm_term=apoorva.joshi)"
       ]

notebooks/advanced_techniques/quantized_vector_ingestion_with_cohere_and_mongodb.ipynb

@@ -11,7 +11,7 @@
         "\n",
         "---\n",
         "\n",
-        "[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/mongodb-developer/GenAI-Showcase/blob/main/notebooks/advanced_techniques/evaluating_information_retrival_techniques_mongondb_langchain.ipynb)\n",
+        "[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/mongodb-developer/GenAI-Showcase/blob/main/notebooks/advanced_techniques/quantized_vector_ingestion_with_cohere_and_mongodb.ipynb)\n",
         "\n",
         "\n",
         "You can view an article version of this notebook here:\n",

notebooks/advanced_techniques/retrieval_optimization.ipynb

@@ -5,7 +5,7 @@
       "id": "98a36217-0e7e-441f-a382-b120d43092e6",
       "metadata": {},
       "source": [
-        "[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/mongodb-developer/GenAI-Showcase/blob/main/notebooks/advanced_techniques/retrieval_cost_latency_optimization.ipynb)\n",
+        "[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/mongodb-developer/GenAI-Showcase/blob/main/notebooks/advanced_techniques/retrieval_optimization.ipynb)\n",
         "\n",
         "[![View Article](https://img.shields.io/badge/View%20Article-blue)](https://www.mongodb.com/company/blog/technical/retrieval-optimization/?utm_campaign=devrel&utm_source=cross-post&utm_medium=organic_social&utm_content=https%3A%2F%2Fgithub.com%2Fmongodb-developer%2FGenAI-Showcase&utm_term=apoorva.joshi)"
       ]