registry.yaml

# yaml-language-server: $schema=./.github/registry_schema.json

# Registry of notebooks to publish on the site.
# Each entry maps a notebook to its metadata for the website.
#
# Required fields:
#   - slug: URL-safe identifier (used in site URLs)
#   - path: Path to the notebook file relative to repo root
#   - title: Display title for the notebook
#   - authors: List of author GitHub usernames
#
# Optional fields:
#   - description: Short description for previews
#   - date: Publication date (YYYY-MM-DD)
#   - tags: List of topic tags

- slug: migrate-gpt-4o-mini-to-gpt-5-1
  path: notebooks/migrate-gpt-4o-mini-to-gpt-5-1.ipynb
  title: "Migrate gpt-4o-mini to gpt-5.1"
  description: "Port a Chat Completions app from gpt-4o-mini to gpt-5.1: rename max_tokens to max_completion_tokens, remove unsupported sampling, and use reasoning_effort and verbosity."
  date: "2026-07-07"
  authors:
    - github: meerakurup
  tags:
    - models
    - inference
    - chat-completions
    - reasoning
    - responses
    - azure-openai

- slug: migrate-gpt-5-5-to-claude-opus-4-8
  path: notebooks/migrate-gpt-5-5-to-claude-opus-4-8.ipynb
  title: "Migrate GPT-5.5 to Claude Opus 4.8"
  description: "Move a Chat Completions workload from GPT-5.5 to Claude Opus 4.8 on Microsoft Foundry with one adapter, side-by-side eval gates, structured output retries, streaming normalization, and rollout checks."
  date: "2026-06-30"
  authors:
    - github: meerakurup
  tags:
    - models
    - inference
    - evaluation
    - sdk
    - azure-openai
    - anthropic

- slug: migrate-oyd-to-foundry-iq
  path: notebooks/migrate-oyd-to-foundry-iq.ipynb
  title: "Migrate Azure OpenAI On Your Data to Foundry IQ"
  description: "Replace On Your Data with a Foundry IQ KB using your existing Search index, auto retrieval, and answer synthesis. Add a Prompt Agent when you need tools or workflows beyond corpus chat."
  date: "2026-06-17"
  authors:
    - github: farzad528
  tags:
    - iq
    - retrieval
    - grounding
    - rag
    - azure-ai-search
    - azure-openai

- slug: foundry-agent-part-1
  path: notebooks/foundry-agent-part-1.ipynb
  title: "Create Your First Agent (Part 1)"
  description: "Step-by-step tutorial to deploy gpt-5.4-mini on Microsoft Foundry, create an AI agent with Web Search, and test it — all from the Foundry portal. Part 1 of 4."
  date: "2026-06-02"
  authors:
    - github: nicholasdbrady
  tags:
    - agents
    - agent-service
    - prompt-agents
    - tools
    - web-search

- slug: foundry-agent-part-2
  path: notebooks/foundry-agent-part-2.ipynb
  title: "Tools and Your First Code (Part 2)"
  description: "Connect your agent to Microsoft Learn and GitHub MCP servers. Handle MCP approval requests, explore the tool catalog, and see your agent defined in YAML and Python."
  date: "2026-06-02"
  authors:
    - github: nicholasdbrady
  tags:
    - agents
    - agent-service
    - tools
    - mcp
    - sdk

- slug: mai-transcribe-1-foundry
  path: notebooks/mai-transcribe-1-foundry.ipynb
  title: "Transcribe Audio with MAI-Transcribe-1"
  description: "Entra-first MAI-Transcribe-1 notebook with Foundry endpoint setup, local audio transcription, translation, diarization fallback guidance, and cost estimation."
  date: "2026-06-02"
  authors:
    - github: anihitk07
  tags:
    - mai
    - models
    - inference
    - speech
    - transcription
    - audio

- slug: mai-voice-1-foundry
  path: notebooks/mai-voice-1-foundry.ipynb
  title: "Generate Speech with MAI-Voice-1"
  description: "MAI-Voice-1 notebook using Foundry endpoint with REST and SDK patterns, long-form synthesis, and character-based cost estimation."
  date: "2026-06-02"
  authors:
    - github: anihitk07
  tags:
    - mai
    - models
    - inference
    - speech
    - text-to-speech
    - audio
    - audio-generation

- slug: mai-image-2
  path: notebooks/mai-image-2.ipynb
  title: "Generate Images with MAI-Image-2 and MAI-Image-2e"
  description: "MAI-Image-2 and MAI-Image-2e text-to-image notebook with prompt variations, parameter tuning, and token-based cost calculations."
  date: "2026-06-02"
  authors:
    - github: anihitk07
  tags:
    - mai
    - models
    - inference
    - images
    - image-generation
    - multimodal

- slug: mai-image-2-foundry
  path: notebooks/mai-image-2-foundry.ipynb
  title: "Call MAI-Image-2 from a Foundry Deployment"
  description: "Foundry-focused MAI-Image-2 notebook covering deployment-based calls, prompt variants, and cost breakdown."
  date: "2026-06-02"
  authors:
    - github: anihitk07
  tags:
    - mai
    - models
    - inference
    - images
    - image-generation
    - multimodal

- slug: mastering-foundry-iq
  path: notebooks/mastering-foundry-iq.ipynb
  title: "Mastering Foundry IQ"
  description: "End-to-end Foundry IQ walkthrough: every Knowledge Source type, one unified Knowledge Base, and integrations with Foundry Agent Service and Microsoft Agent Framework."
  date: "2026-06-02"
  authors:
    - github: farzad528
  tags:
    - iq
    - retrieval
    - grounding
    - azure-ai-search
    - mcp
    - agents
    - agent-service
    - agent-framework

- slug: mastering-foundry-toolbox
  path: notebooks/mastering-foundry-toolbox.ipynb
  title: "Mastering Toolboxes in Microsoft Foundry"
  description: "End-to-end walkthrough of Toolboxes in Microsoft Foundry: every tool type, identity, Tool Search, versioning, governance, and consuming from Agent Framework, LangGraph, and Copilot SDK."
  date: "2026-06-07"
  authors:
    - github: zhuoqunli
  tags:
    - toolbox
    - tools
    - mcp
    - agents
    - agent-service
    - hosted-agents
    - agent-framework
    - langgraph
    - governance
    - identity

- slug: mai-transcribe-1-5
  path: notebooks/mai-transcribe-1-5.ipynb
  title: "Build Speech-to-Text with MAI-Transcribe-1.5"
  description: "Speech API multipart cookbook for MAI-Transcribe-1.5 covering baseline transcription, verbatim mode, phrase-list entity biasing, and language identification."
  date: "2026-06-02"
  authors:
    - github: anihitk07
  tags:
    - mai
    - models
    - inference
    - multimodal

- slug: mai-voice-2
  path: notebooks/mai-voice-2.ipynb
  title: "Build Multilingual TTS with MAI-Voice-2-Preview"
  description: "MAI-Voice-2-Preview notebook with REST calls, multilingual prebuilt voices, gated voice-prompting guidance, and model-card-aligned preview notes."
  date: "2026-06-02"
  authors:
    - github: anihitk07
  tags:
    - mai
    - models
    - inference
    - multimodal

- slug: mai-image-2-5
  path: notebooks/mai-image-2-5.ipynb
  title: "Build a Production Editing Recipe with MAI-Image-2.5"
  description: "Private-preview MAI-Image-2.5 notebook covering text-to-image generation, image edits, safety reminders, and troubleshooting."
  date: "2026-06-02"
  authors:
    - github: anihitk07
  tags:
    - mai
    - models
    - inference
    - multimodal

- slug: sora-video-generation-rest-api
  path: notebooks/sora-video-generation-rest-api.ipynb
  title: "Guide Sora 2 with Images and Audio"
  description: "Use Azure OpenAI REST calls to generate a Sora 2 clip, reuse a frame as an image reference, and add ambient audio."
  date: "2026-06-02"
  authors:
    - github: nicholasdbrady
  tags:
    - azure-openai
    - video
    - video-generation
    - audio
    - audio-generation
    - multimodal
    - responsible-ai
- slug: microsoft-iq-in-foundry
  path: notebooks/microsoft-iq-in-foundry.ipynb
  title: "Microsoft IQ in Foundry"
  description: "Build your own knowledge layer in Foundry IQ: start with your own files (zero setup), then layer in Web IQ, Work IQ, and Fabric IQ, and query every source with one call."
  date: "2026-06-02"
  authors:
    - github: farzad528
  tags:
    - iq
    - retrieval
    - grounding
    - azure-ai-search
    - mcp
    - agents
    - agent-service

- slug: azure-ai-search-custom-schema-citations
  path: notebooks/azure-ai-search-custom-schema-citations.ipynb
  title: "Fix Agent Citations for Custom Azure AI Search Schemas"
  description: "Get real url/title citations from the Azure AI Search tool when your index fields aren't named url/title/content — register the index as an asset with a FieldMapping and use index_asset_id."
  date: "2026-06-05"
  authors:
    - github: farzad528
  tags:
    - azure-ai-search
    - agents
    - agent-service
    - tools
    - grounding
    - retrieval

- slug: llamacloud-index-v2-azure-ai-search
  path: notebooks/llamacloud-index-v2-azure-ai-search.ipynb
  title: "BYO Vector Store: LlamaCloud Index V2 → Azure AI Search"
  description: "Land LlamaCloud Index V2 parses in your own Azure AI Search using the official index-v2-data-sinks exporter, then query them with LlamaIndex Retrieval Harness primitives."
  date: "2026-06-29"
  authors:
    - github: farzad528
  tags:
    - retrieval
    - rag
    - azure-ai-search
    - indexes
    - llamaindex
    - identity
    - iq

- slug: acu-dynamic-hitl
  path: notebooks/acu-dynamic-hitl.ipynb
  title: "Dynamic human review with Content Understanding confidence scores"
  description: "Turn Azure Content Understanding confidence scores into a per-field human-review policy: set one catch target, ship a CSV, and measure what it saves on unseen documents."
  date: "2026-10-06"
  authors:
    - github: colinmurphy326
  tags:
    - content-understanding
    - evaluation
    - governance
    - intelligent-document-processing
    - forward-deployed-engineering