Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
6fd1220
docs(microsoft-agent-framework): 10-API deep dives Vol. 5 for 1.19.0
claude Sep 21, 2026
daab4d0
fix(vol5): correct 8 API bugs found in Codex review
claude Sep 21, 2026
5ec2281
fix(vol5): address second-round Copilot review findings
claude Sep 21, 2026
72edd2b
fix(vol5): address third-round Codex review findings
claude Sep 21, 2026
26cd459
fix(vol5): address fourth-round Codex review findings
claude Sep 21, 2026
e42991f
fix(vol5): add security disclaimer to argument pattern-matching example
claude Sep 21, 2026
2794afd
docs(index): update Python landing page to 1.19.0 and add Vol. 5 link
claude Sep 21, 2026
63e4581
fix(vol5): address four Copilot review findings
claude Sep 21, 2026
21dd9fc
fix(vol5): fix interceptor context access and memory store isolation
claude Sep 21, 2026
766616b
fix(vol5): scope transcript dir by source+owner; non-blocking input
claude Sep 21, 2026
da6cc2f
fix(vol5): streaming timing, owner id, path safety, HITL checkpoint
claude Sep 21, 2026
00dcb80
fix(vol5): base64 path encoding, provider state export, HITL checkpoint
claude Sep 21, 2026
873701d
docs(vol5): clarify WorkflowRunResult iterable and fix API count
claude Sep 21, 2026
ae43ba1
fix(vol5): correct export/import_provider_state method signatures
claude Sep 21, 2026
966e183
fix(v5): refresh checkpoint_id via get_latest() in HITL loop
claude Sep 21, 2026
18a39ee
fix(v5): scope checkpoint storage per run to prevent cross-contamination
claude Sep 21, 2026
820264f
fix(v5): use FileCheckpointStorage not MemoryFileStore for HITL example
claude Sep 21, 2026
57c0f47
fix(v5): fix _safe() empty-string collision and honour line_limit in …
claude Sep 21, 2026
b8fbc0a
fix(v5): add deprecated data/emit event, bound _safe() length, fix gu…
claude Sep 21, 2026
201c05b
fix(v5): give each InMemoryMemoryStore instance its own temp directory
claude Sep 21, 2026
83c741c
fix(maf-v5): make examples run on 1.19.0 and correct What's new table
claude Sep 26, 2026
59d42f5
fix(v5): evict stale topic record on slug reuse in write_topic()
claude Sep 26, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Microsoft Agent Framework (Python)"
description: "Unified Python agent SDK — core stable at agent-framework 1.18.0, with a consolidated Class & API Reference covering 200+ classes across workflows, agents, memory, tools, security, skills, and more."
description: "Unified Python agent SDK — core stable at agent-framework 1.19.0, with a consolidated Class & API Reference covering 200+ classes across workflows, agents, memory, tools, security, skills, and more."
framework: microsoft-agent-framework
language: python
sidebar:
Expand All @@ -19,7 +19,7 @@ import { Card, CardGrid, LinkCard, Aside } from '@astrojs/starlight/components';
```
</Card>
<Card title="Version" icon="information">
Core **1.18.0** stable · `agent-framework-foundry` and `agent-framework-openai` bundled via `agent-framework==1.18.0` · September 2026 · Python 3.10 – 3.13 · consolidated **Class & API Reference**
Core **1.19.0** stable · `agent-framework-foundry` and `agent-framework-openai` bundled via `agent-framework==1.19.0` · September 2026 · Python 3.10 – 3.13 · consolidated **Class & API Reference**
</Card>
<Card title="Best for" icon="puzzle">
Azure-native agents, multi-agent orchestration via `WorkflowBuilder`, cross-framework A2A, declarative YAML agents.
Expand Down Expand Up @@ -118,11 +118,12 @@ A guided reading order across the comprehensive guide, 2025 features, advanced a
<LinkCard title="10-Class Deep Dives Vol. 2 (1.16.0)" href="/microsoft-agent-framework-guide/python/microsoft_agent_framework_python_class_deep_dives_v2/" description="Source-verified deep dives for the second batch of 10 classes — verified against agent-framework 1.16.0." />
<LinkCard title="10-Class Deep Dives Vol. 3 (1.17.0)" href="/microsoft-agent-framework-guide/python/microsoft_agent_framework_python_class_deep_dives_v3/" description="Source-verified deep dives: WorkflowBuilder, SlidingWindowStrategy, TruncationStrategy, ContextWindowCompactionStrategy, LocalEvaluator, InlineSkill, FileAccessProvider, MemoryContextProvider, FileHistoryProvider, MCPWebsocketTool — all verified against agent-framework 1.17.0." />
<LinkCard title="10-API Deep Dives Vol. 4 (1.18.0)" href="/microsoft-agent-framework-guide/python/microsoft_agent_framework_python_class_deep_dives_v4/" description="Source-verified deep dives: VectorStoreField, VectorStoreCollectionDefinition, InMemoryCollection, InMemoryStore, Filter, FilterGroup, SecretString, load_settings (function), create_agent_hooks_middleware (function), GroupChatBuilder — all verified against agent-framework 1.18.0." />
<LinkCard title="10-API Deep Dives Vol. 5 (1.19.0)" href="/microsoft-agent-framework-guide/python/microsoft_agent_framework_python_class_deep_dives_v5/" description="Source-verified deep dives: WorkflowEvent, AgentContext, MiddlewareBundle, ConversationSplit/ConversationSplitter, VectorStoreHistoryProvider, MemoryStore/MemoryFileStore, MemoryTopicRecord, WorkflowRunResult, FunctionInvocationContext, ChatOptions — all verified against agent-framework 1.19.0." />
</CardGrid>

## What's shipped (September 2026 introspection)

- **Stable core** — `agent-framework-core 1.18.0` (September 2026). The full class-by-class API surface — previously spread across 49 per-volume "class deep dive" pages — is now consolidated into one [Class & API Reference](/microsoft-agent-framework-guide/python/microsoft_agent_framework_python_comprehensive_guide/#class--api-reference) section of the comprehensive guide (plus an azure-ai-agents add-on appendix). See the [Revision history](#revision-history) below for the version-by-version summary.
- **Stable core** — `agent-framework-core 1.19.0` (September 2026). The full class-by-class API surface — previously spread across 49 per-volume "class deep dive" pages — is now consolidated into one [Class & API Reference](/microsoft-agent-framework-guide/python/microsoft_agent_framework_python_comprehensive_guide/#class--api-reference) section of the comprehensive guide (plus an azure-ai-agents add-on appendix). See the [Revision history](#revision-history) below for the version-by-version summary.
- **First-party chat clients** — `agent_framework.foundry.FoundryChatClient`, `agent_framework.openai.OpenAIChatClient`, `agent_framework.anthropic.AnthropicClient`, plus Bedrock / Ollama in the `1.0.0b` provider line.
- **Skills (experimental)** — `MemoryStore`, `SkillResource`, `InlineSkillResource`, `ClassSkill`, `InlineSkill`, `FileSkill` now emit `ExperimentalWarning` on import — do not depend on these APIs in production yet.
- **Middleware** — `@chat_middleware` / `@agent_middleware` / `@function_middleware` decorators and base classes; pass `middleware=[...]` (must be a list in 2026 releases).
Expand Down Expand Up @@ -169,6 +170,7 @@ Ready for the full walk-through? **[Start with Core Fundamentals →](/microsoft

| Date | Version | Changes |
|------|---------|---------|
| 2026-09-21 | 1.19.0 | Installed and introspected `agent-framework==1.19.0` source. Added [10-API Deep Dives Vol. 5](/microsoft-agent-framework-guide/python/microsoft_agent_framework_python_class_deep_dives_v5/) covering WorkflowEvent, AgentContext, MiddlewareBundle, ConversationSplit/ConversationSplitter, VectorStoreHistoryProvider, MemoryStore/MemoryFileStore, MemoryTopicRecord, WorkflowRunResult, FunctionInvocationContext, and ChatOptions — all with source-verified constructors, method tables, and runnable examples. Vol. 5 LinkCard added to Reference section. Version card and description updated to 1.19.0. |
| 2026-09-14 | 1.18.0 | Installed and introspected `agent-framework==1.18.0` source. Added [10-API Deep Dives Vol. 4](/microsoft-agent-framework-guide/python/microsoft_agent_framework_python_class_deep_dives_v4/) covering eight classes (VectorStoreField, VectorStoreCollectionDefinition, InMemoryCollection, InMemoryStore, Filter, FilterGroup, SecretString, GroupChatBuilder) and two functions (load_settings, create_agent_hooks_middleware) — all with source-verified constructors, method tables, and runnable examples. Vol. 2 and Vol. 3 LinkCards added to Reference section. Version card updated to 1.18.0. |
| 2026-09-08 | 1.17.0 | Consistency sweep. Version card and page description moved 1.15.0 → 1.17.0 to match the newest source-verified deep dives (Vol. 3, `agent-framework==1.17.0`); comprehensive-guide header now states agent-framework 1.17.0 as latest and 1.14.0 as the verified-against version. Zero → Hero deep links into the 2025-features page retargeted to headings that exist. No package installation or symbol verification performed. |
| 2026-08-24 | 1.15.0 | Upgraded to agent-framework 1.15.0 (latest). Added [10-Class Deep Dives](/microsoft-agent-framework-guide/python/microsoft_agent_framework_python_class_deep_dives/) document covering WorkflowViz, FileMemoryProvider, AgentModeProvider, BackgroundAgentsProvider, ToolApprovalMiddleware, SwitchCaseEdgeGroup, MessageInjectionMiddleware, ToolResultCompactionStrategy, SummarizationStrategy, and TokenBudgetComposedStrategy — all source-verified with runnable examples. |
Expand Down
Loading
Loading