Forgebook

Your cookbook for building AI with Microsoft Foundry.

Recipes (13)

Fix Agent Citations for Custom Azure AI Search Schemas

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.

farzad528
2026-06-05
azure-ai-search agents agent-service tools grounding retrieval

Create Your First Agent (Part 1)

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.

nicholasdbrady
2026-06-02
agents agent-service prompt-agents tools web-search

Tools and Your First Code (Part 2)

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.

nicholasdbrady
2026-06-02
agents agent-service tools mcp sdk

Generate Images with MAI-Image-2 and MAI-Image-2e

MAI-Image-2 and MAI-Image-2e text-to-image notebook with prompt variations, parameter tuning, and token-based cost calculations.

anihitk07
2026-06-02
mai models inference images image-generation multimodal

Build a Production Editing Recipe with MAI-Image-2.5

Private-preview MAI-Image-2.5 notebook covering text-to-image generation, image edits, safety reminders, and troubleshooting.

anihitk07
2026-05-28
mai models inference multimodal

Call MAI-Image-2 from a Foundry Deployment

Foundry-focused MAI-Image-2 notebook covering deployment-based calls, prompt variants, and cost breakdown.

anihitk07
2026-06-02
mai models inference images image-generation multimodal

Build Speech-to-Text with MAI-Transcribe-1.5

Speech API multipart cookbook for MAI-Transcribe-1.5 covering baseline transcription, verbatim mode, phrase-list entity biasing, and language identification.

anihitk07
2026-05-28
mai models inference multimodal

Transcribe Audio with MAI-Transcribe-1

Entra-first MAI-Transcribe-1 notebook with Foundry endpoint setup, local audio transcription, translation, diarization fallback guidance, and cost estimation.

anihitk07
2026-06-02
mai models inference speech transcription audio

Generate Speech with MAI-Voice-1

MAI-Voice-1 notebook using Foundry endpoint with REST and SDK patterns, long-form synthesis, and character-based cost estimation.

anihitk07
2026-06-02
mai models inference speech text-to-speech audio audio-generation

Build Multilingual TTS with MAI-Voice-2-Preview

MAI-Voice-2-Preview notebook with REST calls, multilingual prebuilt voices, gated voice-prompting guidance, and model-card-aligned preview notes.

anihitk07
2026-05-28
mai models inference multimodal

Mastering Foundry IQ

End-to-end Foundry IQ walkthrough: every Knowledge Source type, one unified Knowledge Base, and integrations with Foundry Agent Service and Microsoft Agent Framework.

farzad528
2026-05-27
iq retrieval grounding azure-ai-search mcp agents agent-service agent-framework

Microsoft IQ in Foundry

Build a Microsoft IQ knowledge layer in Foundry IQ — federate Work IQ, Fabric IQ, and Web IQ into one Knowledge Base, then query each IQ plus a cross-source question.

farzad528
2026-05-29
iq retrieval grounding azure-ai-search mcp agents agent-service

Guide Sora 2 with Images and Audio

Use Azure OpenAI REST calls to generate a Sora 2 clip, reuse a frame as an image reference, and add ambient audio.

nicholasdbrady
2026-05-27
azure-openai video video-generation audio audio-generation multimodal responsible-ai

Start forging 

git clone https://github.com/microsoft-foundry/forgebook.git
cd forgebook
pip install -r requirements.txt
jupyter notebook