Skapa Agent Framework-appar med en kodningsagent

Note

En Microsoft Agent Framework-builder-skill för .NET är inte tillgänglig ännu. Använd självstudien för att komma igång med .NET och .NET-exempel medan arbetet med .NET-byggfärdigheter spåras.

Microsoft Agent Framework-builder-färdigheten för Python, agent-framework-builder-python, ger kompatibla kodagenter Microsoft-underhållen vägledning för att skapa Python Agent Framework-lösningar. Det hjälper kodningsagenten att välja ett lämpligt mönster och stegvis läsa in fokuserad vägledning för uppgiften.

Färdigheten kan vägleda arbetet med:

• Vanliga agenter, modellleverantörer, verktyg, godkännanden, sessioner, historik och kontextleverantörer.
• Utnyttja agenter med planering, todos, minne, komprimering, filer, bakgrundsagenter, shellverktyg och loopar.
• Funktionella arbetsflöden och grafarbetsflöden, inbyggda orkestreringar och deklarativa definitioner.
• Utvärdering, observerbarhet, middleware, anpassade klienter, anpassade agenter och integreringar.
• Egenvärd och Microsoft Foundry värdbaserad agentutveckling.

Färdigheten är endast för Python. Den ger utvecklingsvägledning till en extern kodningsagent. det är inte ett Python paket, installeras inte av pip install agent-frameworkoch körs inte i ditt Agent Framework-program.

Important

Den här färdigheten för kodningsagent skiljer sig från Agent Skills för runtime. Runtime-färdigheter läses in av en Agent Framework-agent medan programmet körs. Builder-färdigheten hjälper en kodningsagent att skapa eller ändra din applikations källkod.

Tip

Para ihop byggarfärdigheten med Microsoft Learn MCP Server. Kunskapen ger den kodande agenten fokuserad vägledning om Agent Framework-arbetsflöde och implementering, medan Learn MCP Server låter den söka i aktuell Microsoft-dokumentation, hämta fullständiga artiklar och hitta kodexempel under uppgiften. Konfigurera den här offentliga, oautentiserade Streamable HTTP-slutpunkten i en kompatibel kodningsagent:

https://learn.microsoft.com/api/mcp

Förutsättningar

• En kodningsagent som stöder den öppna Agent Skills specification.
• GitHub CLI med förhandsversionskommandona gh skill eller Node.js 22.20 eller senare om du använder cross-agent-skillsCLI.
• Python 3.11 eller senare för nya Agent Framework-program. Agent Framework 1.23 stöder fortfarande Python 3.10, men Python 3.10 har nått slutet på livscykeln uppströms.

GitHub CLI-hantering av skills är en förhandsversion och kan komma att ändras.

Granska och installera med GitHub CLI

Förhandsgranska den utgivna skill innan du installerar den:

gh skill preview microsoft/agent-framework agent-framework-builder-python@python-1.23.0

Installera den senaste taggade versionen:

gh skill install microsoft/agent-framework agent-framework-builder-python

Fäst Python 1.23-versionen när du behöver reproducerbara anvisningar:

gh skill install microsoft/agent-framework agent-framework-builder-python@python-1.23.0

Standardinstallationen är projektomfattande och är avsedd för GitHub Copilot i icke-interaktiv användning. Välj en annan kodningsagent som stöds eller användningsområde för användare när det behövs:

gh skill install microsoft/agent-framework agent-framework-builder-python \
  --agent claude-code \
  --scope user

gh skill install microsoft/agent-framework agent-framework-builder-python \
  --agent cursor

gh skill install microsoft/agent-framework agent-framework-builder-python \
  --agent codex

Aktuella klient- och scopealternativ finns i gh skill install.

Installera med CLI för cross-agent skills

Som ett alternativ kan du installera skill med cross-agent-CLI: skills

npx skills add microsoft/agent-framework --skill agent-framework-builder-python

Granska CLI:s AI-agenter som stöds och körningskrav före installationen.

Använd kompetensen

Instruera kodagenten naturligt. Kompatibla klienter upptäcker och aktiverar skillen via metadata; anta inte ett universellt snedstreckskommando.

Exempeluppmaningar:

• Build a Python Agent Framework agent with Microsoft Foundry, function tools, sessions, and tests.
• Add approval-required tools and persistent conversation history to this Agent Framework application.
• Convert this multi-agent design into an Agent Framework workflow and add checkpointing.
• Create a harness agent with planning, todos, file access, and safe shell tooling.
• Review this Python Agent Framework application for current APIs and package requirements.
• Prepare this Agent Framework agent for Foundry hosting and add an evaluation plan.

Inkludera begränsningar som modellprovidern, värdmål, beständighetskrav, säkerhetsgräns och Python version som stöds när du känner till dem.

Vad kodningsagenten ska göra

Färdighet instruerar en kodagent att:

• Välj det minsta lämpliga mönstret, till exempel en vanlig agent, harness, arbetsflöde, orkestrering eller deklarativ definition.
• Läs endast in relevanta markerade referenser.
• Föredra aktuell Microsoft Learn-vägledning, offentliga API-referenser, information om paketlivscykel och underhållna exempel för detaljer som kan ändras ofta.
• Installera smala paketuppsättningar i stället för att anta att varje integrering är stabil eller krävs.
• Bevara explicita gränser för session, godkännande, autentisering och värdtjänst.
• Verifiera det genererade programmet med kodförrådets befintliga tester, typkontroller och körbara exempel.

Färdigheten garanterar inte att genererad kod är produktionsklar. Granska kodningsagentens plan, paketval, säkerhetsgränser, kommandon och genererade ändringar före godkännande.

Versionshantering och förtroende

Skillen är en offentlig, installerbar, Microsoft-underhållen konsumentskill som släppts i lagringsplatstaggen python-1.23.0. Dess skill-metadata-version är 0.3.

• Använd det okvalificerade installationskommandot för den senaste taggade utgåvan.
• Fäst @python-1.23.0 när reproducerbarhet spelar roll.
• Använd @main endast när du avsiktligt vill ha ej publicerad vägledning.
• Förhandsgranska skillinnehåll innan du installerar och granska uppdateringar innan du litar på nya skript eller instruktioner.

För källreferenser och fokusreferenser, se:

• Släppt byggarfärdighet
• Kompetenskatalog för Agent Framework
• pull request för Builder-skill

Nästa steg

Skapa din första agent

Gå djupare:

• Python Agent Framework-exempel
• Agentkunskaper som läses in vid körning
• Agent Harness
• Hysa Agent Framework-program

Note

En Microsoft Agent Framework-builderfärdighet för Go är inte tillgänglig ännu. Använd go get-started-självstudien och Agent Framework Go-exempel för aktuell vägledning.