Skip to content
agent-framework logo

Create Agent with Microsoft Agent Framework

agent-framework

Create AI agents and workflows using Microsoft Agent Framework SDK. Supports single-agent and multi-agent workflow patterns. USE FOR: create agent, build agent, scaffold agent, new agent, agent framework, workflow pattern, multi-agent, MCP tools, create workflow. DO NOT USE FOR: deploying agents ...

MoonAxis/azure-stack0installs2stars

SKILL.md

Full skill instructions

Create Agent with Microsoft Agent Framework

Build AI agents, agentic apps, and multi-agent workflows using Microsoft Agent Framework SDK.

Quick Reference

PropertyValue
SDKMicrosoft Agent Framework (Python)
PatternsSingle Agent, Multi-Agent Workflow
ServerAzure AI Agent Server SDK (HTTP)
DebugAI Toolkit Agent Inspector + VSCode
Best ForEnterprise agents with type safety, checkpointing, orchestration

When to Use This Skill

Use when the user wants to:

  • Create a new AI agent or agentic application
  • Scaffold an agent with tools (MCP, function calling)
  • Build multi-agent workflows with orchestration patterns
  • Add HTTP server mode to an existing agent
  • Configure F5/​debug support for VSCode

Defaults

  • Language: Python
  • SDK: Microsoft Agent Framework (pin version 1.0.0b260107)
  • Server: HTTP via Azure AI Agent Server SDK
  • Environment: Virtual environment (create or detect existing)

References

TopicFileDescription
Server Patternreferences/​agent-as-server.mdHTTP server wrapping (production)
Debug Setupreferences/​debug-setup.mdVS Code configs for Agent Inspector
Agent Samplesreferences/​agent-samples.mdSingle agent, tools, MCP, threads
Workflow Basicsreferences/​workflow-basics.mdExecutor types, handler signatures, edges, WorkflowBuilder — start here for any workflow
Workflow Agentsreferences/​workflow-agents.mdAgents as executor nodes, linear pipeline, run_stream event consumption
Workflow Foundryreferences/​workflow-foundry.mdFoundry agents with bidirectional edges, loop control, register_executor factories

💡 Tip: For advanced patterns (Reflection, Switch-Case, Fan-out/​Fan-in, Loop, Human-in-Loop), search microsoft/​agent-framework on GitHub.

MCP Tools

This skill delegates to microsoft-foundry MCP tools for model and project operations:

ToolPurpose
foundry_models_listBrowse model catalog for selection
foundry_models_deployments_listList deployed models for selection
foundry_resource_getGet project endpoint

Creation Workflow

  1. Gather context (read agent-as-server.md + debug-setup.md + code samples)
  2. Select model & configure environment
  3. Implement agent/​workflow code + HTTP server mode + .vscode/ configs
  4. Install dependencies (venv + requirements.txt)
  5. Verify startup (Run-Fix loop)
  6. Documentation

Step 1: Gather Context

Read reference files based on user's request:

Always read these references:

  • Server pattern: agent-as-server.md (required — HTTP server is the default)
  • Debug setup: debug-setup.md (required — always generate .vscode/ configs)

Read the relevant code sample:

  • Code samples: agent-samples.md, workflow-basics.md, workflow-agents.md, or workflow-foundry.md

Model Selection: Use microsoft-foundry skill's model catalog to help user select and deploy a model.

Recommended: Search microsoft/​agent-framework on GitHub for advanced patterns.

Step 2: Select Model & Configure Environment

Decide on the model BEFORE coding.

If user hasn't specified a model, use microsoft-foundry skill to list deployed models or help deploy one.

ALWAYS create/​update .env file:

FOUNDRY_PROJECT_ENDPOINT=<project-endpoint>
FOUNDRY_MODEL_DEPLOYMENT_NAME=<model-deployment-name>
  • Standard flow: Populate with real values from user's Foundry project
  • Deferred Config: Use placeholders, remind user to update before running

Step 3: Implement Code

All three are required by default:

  1. Agent/​Workflow code: Use gathered context to structure the agent or workflow
  2. HTTP Server mode: Wrap with Agent-as-Server pattern from agent-as-server.md — this is the default entry point
  3. Debug configs: Generate .vscode/​launch.json and .vscode/​tasks.json using templates from debug-setup.md

⚠️ Warning: Only skip server mode or debug configs if the user explicitly requests a "minimal" or "no server" setup.

Step 4: Install Dependencies

  1. Generate/​update requirements.txt
# pin version to avoid breaking changes

# agent framework
agent-framework-azure-ai==1.0.0b260107
agent-framework-core==1.0.0b260107

# agent server (for HTTP server mode)
azure-ai-agentserver-core==1.0.0b10
azure-ai-agentserver-agentframework==1.0.0b10

# debugging support
debugpy
agent-dev-cli
  1. Use a virtual environment to avoid polluting the global Python installation

⚠️ Warning: Never use bare python or pip — always use the venv-activated versions or full paths (e.g., .venv/​bin/​pip).

Step 5: Verify Startup (Run-Fix Loop)

Enter a run-fix loop until no startup errors:

  1. Run the main entrypoint using the venv's Python (e.g., .venv/​Scripts/​python main.py on Windows, .venv/​bin/​python main.py on macOS/​Linux)
  2. If startup fails: Fix error → Rerun
  3. If startup succeeds: Stop server immediately

Guardrails:

  • ✅ Perform real run to catch startup errors
  • ✅ Cleanup after verification (stop HTTP server)
  • ✅ Ignore environment/​auth/​connection/​timeout errors
  • ❌ Don't wait for user input
  • ❌ Don't create separate test scripts
  • ❌ Don't mock configuration

Step 6: Documentation

Create/​update README.md with setup instructions and usage examples.

Error Handling

ErrorCauseResolution
ModuleNotFoundErrorMissing SDKRun pip install agent-framework-azure-ai==1.0.0b260107 in venv
AgentRunResponseUpdate not foundWrong SDK versionPin to 1.0.0b260107 (breaking rename in newer versions)
Agent name validation errorInvalid charactersUse alphanumeric + hyphens, start/​end with alphanumeric, max 63 chars
Async credential errorWrong importUse azure.identity.aio.DefaultAzureCredential (not azure.identity)

More skills from MoonAxis

deploy-model logo
MoonAxis/azure-stack

deploy-model

Unified Azure OpenAI model deployment skill with intelligent intent-based routing. Handles quick preset deployments, fully customized deployments (version/SKU/capacity/RAI policy), and capacity discovery across regions and projects. USE FOR: deploy model, deploy gpt, create deployment, model depl...

2 0
View
azure-observability logo
MoonAxis/azure-stack

azure-observability

Azure Observability Services including Azure Monitor, Application Insights, Log Analytics, Alerts, and Workbooks. Provides metrics, APM, distributed tracing, KQL queries, and interactive reports.

2 0
View

Azure AI Document Translation SDK for batch translation of documents with format preservation. Use for translating Word, PDF, Excel, PowerPoint, and other document formats at scale. Triggers: "document translation", "batch translation", "translate documents", "DocumentTranslationClient".

2 0
View
agentic-eval logo
MoonAxis/azure-stack

agentic-eval

Patterns and techniques for evaluating and improving AI agent outputs. Use this skill when: - Implementing self-critique and reflection loops - Building evaluator-optimizer pipelines for quality-critical generation - Creating test-driven code refinement workflows - Designing rubric-based or LLM-a...

2 0
View
azure-ai-translation-text-py logo
MoonAxis/azure-stack

azure-ai-translation-text-py

Azure AI Text Translation SDK for real-time text translation, transliteration, language detection, and dictionary lookup. Use for translating text content in applications. Triggers: "text translation", "translator", "translate text", "transliterate", "TextTranslationClient".

2 0
View

Azure Monitor OpenTelemetry Exporter for Python. Use for low-level OpenTelemetry export to Application Insights. Triggers: "azure-monitor-opentelemetry-exporter", "AzureMonitorTraceExporter", "AzureMonitorMetricExporter", "AzureMonitorLogExporter".

2 0
View
capacity logo
MoonAxis/azure-stack

capacity

Discovers available Azure OpenAI model capacity across regions and projects. Analyzes quota limits, compares availability, and recommends optimal deployment locations based on capacity requirements. USE FOR: find capacity, check quota, where can I deploy, capacity discovery, best region for capac...

2 0
View
import-infrastructure-as-code logo
MoonAxis/azure-stack

import-infrastructure-as-code

Import existing Azure resources into Terraform using Azure CLI discovery and Azure Verified Modules (AVM). Use when asked to reverse-engineer live Azure infrastructure, generate Infrastructure as Code from existing subscriptions/resource groups/resource IDs, map dependencies, derive exact import ...

2 0
View
azure-search-documents-py logo
MoonAxis/azure-stack

azure-search-documents-py

Azure AI Search SDK for Python. Use for vector search, hybrid search, semantic ranking, indexing, and skillsets. Triggers: "azure-search-documents", "SearchClient", "SearchIndexClient", "vector search", "hybrid search", "semantic search".

2 0
View

Azure AI Content Understanding SDK for Python. Use for multimodal content extraction from documents, images, audio, and video. Triggers: "azure-ai-contentunderstanding", "ContentUnderstandingClient", "multimodal analysis", "document extraction", "video analysis", "audio transcription".

2 0
View
azure-data-tables-py logo
MoonAxis/azure-stack

azure-data-tables-py

Azure Tables SDK for Python (Storage and Cosmos DB). Use for NoSQL key-value storage, entity CRUD, and batch operations. Triggers: "table storage", "TableServiceClient", "TableClient", "entities", "PartitionKey", "RowKey".

2 0
View
entra-app-registration logo
MoonAxis/azure-stack

entra-app-registration

Guides Microsoft Entra ID app registration, OAuth 2.0 authentication, and MSAL integration. USE FOR: create app registration, register Azure AD app, configure OAuth, set up authentication, add API permissions, generate service principal, MSAL example, console app auth, Entra ID setup, Azure AD au...

2 0
View

Popular AI tools

Kaiber logo
Video

Kaiber

Generate, edit, and beat-sync AI video with leading models in one workspace.

Paid
View
Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View

Transform Your Design with AI Designer by ImgCreator.ai

Freemium
View
Akool AI logo
Content & writing

Akool AI

Revolutionizing Video Production with AI-Powered Creativity

Paid
View

Extend an image past the frame and let AI fill the new aspect ratio.

Freemium
View
StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
C

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View