MAF v1 — Observability with OpenTelemetry (Python + .NET)
Wire OpenTelemetry spans for agent runs with GenAI attributes, using console export for dev and OTLP for production tracing.
AI Engineering
MAF v1 — Middleware and the Agent Pipeline (Python + .NET)
Use middleware to wrap agent runs, intercept tool calls, and redact PII before the LLM sees it in both Python and .NET safely.
MAF v1 — Context Providers (Python + .NET)
Add per-request context with focused providers, compose them before each LLM call, and plug in TextSearchProvider for simple RAG.
Building a Multi-Agent E-Commerce Platform: The Complete Guide
Most AI agent tutorials end at “hello world.” You build a single agent with one or two tools, it answers a few questions, and that is it. The gap between that tutorial and a production system with multiple agents, authentication, observability, and a real frontend is enormous.
AI Agents: Concepts and Your First Implementation
Revised with .NET examples — A newer version of this article, covering both Python and .NET, is available as part of the MAF v1: Python and .NET series: MAF v1 — 01-first-agent, MAF v1 — 02-add-tools.
Prompt Engineering for AI Agents -- Grounding, Roles, and YAML Configuration
Revised with .NET examples — A newer version of this article, covering both Python and .NET, is available as part of the MAF v1: Python and .NET series: MAF v1 — 24-prompt-engineering. The newer version pulls role-specific behavior out of the system prompt and into a context provider, so you don’t re-instantiate the agent per role. The five concerns and YAML composition below are still the canonical architecture; the new chapter shows the modernised wiring.
Building Domain-Specific Tools -- Giving Agents Real Capabilities
Revised with .NET examples — A newer version of this article, covering both Python and .NET, is available as part of the MAF v1: Python and .NET series: MAF v1 — 02-add-tools.
Multi-Agent Architecture: Orchestration and the A2A Protocol
Revised with .NET examples — A newer version of this article, covering both Python and .NET, is available as part of the MAF v1: Python and .NET series: MAF v1 — 14-handoff-orchestration, MAF v1 — Putting it all together (Ch21).
Observability -- Tracing Multi-Agent Workflows with OpenTelemetry
Revised with .NET examples — A newer version of this article, covering both Python and .NET, is available as part of the MAF v1: Python and .NET series: MAF v1 — 07-observability-otel.
Frontend: Rich Cards and Streaming Responses
Revised with .NET examples — A newer version of this article, covering both Python and .NET, is available as part of the MAF v1: Python and .NET series: MAF v1 — 03-streaming-and-multiturn.
Production Readiness: Auth, RBAC, and Deployment
Revised, split, and expanded — The two halves of this article are now separate chapters in the MAF v1: Python and .NET series: the auth + hardening half is covered by MAF v1 — 20c production hardening (with the password reset, refresh-token rotation, and graceful secret rotation that the original missed), and the deployment half is covered by MAF v1 — 25 deployment (with the .NET twin Dockerfile and a dev.sh that polls instead of sleeping). The architecture below is still the canonical reference for the combined story.
Agent Memory -- Remembering Across Conversations
Revised with .NET examples — A newer version of this article, covering both Python and .NET, is available as part of the MAF v1: Python and .NET series: MAF v1 — 04-sessions, MAF v1 — 05-context-providers.
