Use when cutting a Python release for the microsoft/agent-framework monorepo. Triggers on "bump py versions", "cut a python release", "prepare release PR for python", "release py packages", "bump python to X.Y.Z", or similar requests to bump Python package versions and prepare a release PR. Handles all four lifecycle tiers (alpha, beta, rc, released) with CHANGELOG-driven selective bumps, floor bound checks, and post-bump validation.
Code quality checks, linting, formatting, and type checking commands for the Agent Framework Python codebase. Use this when running checks, fixing lint errors, or troubleshooting CI failures.
Coding standards, conventions, and patterns for developing Python code in the Agent Framework repository. Use this when writing or modifying Python source files in the python/ directory.
Guidance for package and feature lifecycle in the Agent Framework Python codebase, including stage meanings, feature-stage decorators, feature enums, and how to move APIs from one stage to the next.
AG-UI protocol integration for building agent UIs with the AG-UI standard. - AgentFrameworkAgent - Wraps agents for AG-UI compatibility - AgentFrameworkWorkflow - Wraps native Workflow objects, or accepts workflowfactory(threadid) for thread-scoped workflow instances without subclassing - AGUIChatClient - Chat client that speaks AG-UI protocol - AGUIHttpService - HTTP service for AG-UI endpoints - **agentframeworkmessagestoaguihosthistory()* - Converts persisted Agent Framework messages to bounded AG-UI Host history while retaining MCP widget payloads and model replay metadata - *AGUIEventConverter* - Converts between Agent…
agent-framework-azure-contentunderstanding integrates Azure Content Understanding (CU) into the Agent Framework as a context provider. It automatically analyzes file attachments (documents, images, audio, video) and injects structured results into the LLM context. - **contextprovider.py** — Main provider implementation. Overrides before_run() to detect file attachments, call the CU API, manage session state with multi-document tracking, and auto-register retrieval tools for follow-up turns. - Analyzer auto-detection — When analyzer_id=None (default), resolveanalyzer_id() selects the CU analyzer based on media type prefix: audio/ → prebuilt-audioSearch,…
Azure Cosmos DB for NoSQL integrations for Agent Framework. Container name is configured on the provider. session_id is used as the partition key. Vector collections require an application-provided string key stored as id and a container partition key of /id. Container vector and indexing policies are created only by ensurecollectionexists() and validated before use. Existing incompatible containers are never updated or recreated. Supported vector element types are float32, int8, and uint8. Euclidean search is supported, but Euclidean score thresholds fail…
Long-term semantic memory for agents, backed by Azure Cosmos DB via the Azure Cosmos DB Agent Memory Toolkit. - CosmosMemoryContextProvider - Context provider that integrates Cosmos DB-backed semantic memory (facts, procedural/episodic memories, and user/thread summaries) into agents. - Requires the azure-cosmos-agent-memory toolkit and an AI Foundry endpoint (used for both embeddings and fact extraction). - Set a stable userid in state["userid"] or session.state["user_id"] for long-term, cross-session memory. Without it, memory scopes to the ephemeral session id and the provider logs…
Integration with Anthropic Claude as a managed agent (Claude Agent SDK). This package is for Claude's managed agent functionality. For basic Claude chat, use agent-framework-anthropic instead.
YAML/JSON-based declarative agent and workflow definitions. DefaultMCPToolHandler caches/coalesces sessions only without a client_provider. With a provider, every invocation (including tools/list) gets a fresh tool/session, even if the provider returns None or a shared HTTP client. Invocation cleanup closes the session and any internally owned fallback client, never caller-owned HTTP clients. Shutdown waits for active provider-backed invocations to clean up. Calling aclose() from an active invocation's context (including inherited child tasks and cleanup) raises RuntimeError before changing handler state; shutdown must…
Interactive developer UI for testing and debugging agents and workflows. Text content carrying additionalproperties["modeloutput_kind"] == "refusal" is mapped to native Responses refusal parts and events. Mapper aggregation, live rendering, and recovery state retain text/refusal boundaries by item and content index. DevUI is a development-only sample app, not a production hosting surface. Authentication is enabled by default. Unauthenticated mode is allowed only on localhost / 127.0.0.1; 0.0.0.0, LAN IPs, and hostnames require DEVUIAUTHTOKEN or --auth-token.
Integration with GitHub Copilot extensions. buildsessionkwargs forwards options to the SDK verbatim except for a few keys that get an explicit default: onpermissionrequest (deny-all) and enablefilehooks (False, so a session behaves the same way in every working directory). Callers opt in through defaultoptions or per-run options. Keep such defaults to options the working directory controls: options that only shape prompt context (for example enablehostgit_operations) are deliberately left alone. When the agent applies the enablefilehooks default and the working directory actually…
Plain text files in a repository that tell a coding agent how the project works: commands to run, conventions to follow and things to avoid. CLAUDE.md, AGENTS.md, cursor rules and skills are the common kinds.
CLAUDE.md or AGENTS.md?
CLAUDE.md is read by Claude Code. AGENTS.md is an open format that Codex, Cursor and other agents read. Many projects keep one and point the other at it.
What is a skill?
A folder with a SKILL.md that describes one capability, such as filling PDFs or reviewing code. The agent loads it only when the task calls for it.
Can I search my own team's files too?
Your agents already can, over MCP, limited to the files you're allowed to read. Searching them from this page is coming.
MicrosoftSkill