Creare app di Agent Framework con un agente di codifica

La builder skill di Microsoft Agent Framework per .NET, agent-framework-builder-dotnet, offre agli agenti di coding compatibili linee guida curate da Microsoft per la creazione di soluzioni Agent Framework .NET (C#). Consente all'agente di coding di scegliere un pattern appropriato e di caricare progressivamente linee guida incentrate sull'attività.

La competenza può guidare il lavoro con:

  • Agenti semplici, provider di modelli, strumenti, sessioni, cronologia, provider di contesto e middleware.
  • Sfruttare gli agenti con todos, modalità, memoria, approvazioni, competenze, agenti in background, strumenti della shell, compattazione e cicli.
  • Flussi di lavoro e orchestrazioni integrate e definizioni dichiarative.
  • Valutazione, osservabilità, client personalizzati, agenti personalizzati e integrazioni.
  • Hosting e deployment.

L'abilità fornisce indicazioni sullo sviluppo per un agente di codifica esterno. Non è un pacchetto NuGet e non viene eseguito all'interno della tua applicazione Agent Framework.

Importante

Questa competenza dell'agente di codifica è diversa dalle competenze dell'agente di runtime. Le competenze di runtime vengono caricate da un agente di Agent Framework durante l'esecuzione dell'applicazione. La competenza builder consente a un agente di codifica di creare o modificare il codice sorgente dell'applicazione.

Tip

Associare la builder skill al Microsoft Learn MCP Server. La competenza fornisce all'agente di codifica indicazioni mirate sul flusso di lavoro e sull'implementazione di Agent Framework, mentre Learn MCP Server consente di eseguire ricerche nella documentazione Microsoft aggiornata, recuperare gli articoli completi e trovare esempi di codice durante l'attività. Configurare questo endpoint HTTP pubblico e non autenticato streamable in un agente di codifica compatibile:

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

Prerequisiti

  • Agente di codifica che supporta la specifica open Agent Skills.
  • GitHub CLI con i comandi di anteprima gh skill, oppure Node.js 22.20 o versione successiva se si usa la CLI cross-agent skills.
  • Un .NET SDK attualmente supportato per le nuove applicazioni di Agent Framework.

La gestione skill di GitHub CLI è in anteprima e soggetta a modifiche.

Esaminare e installare con GitHub CLI

La skill builder .NET non è ancora in una versione con tag, quindi è necessario specificare il @main ref. Visualizzare in anteprima la skill prima di installarla:

gh skill preview microsoft/agent-framework agent-framework-builder-dotnet@main

Installa la skill:

gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main

L'installazione predefinita è con ambito progetto e ha come destinazione GitHub Copilot in uso non interattivo. Selezionare un altro agente di codifica supportato o ambito utente quando necessario:

gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main \
  --agent claude-code \
  --scope user

gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main \
  --agent cursor

gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main \
  --agent codex

Per le opzioni di ambito e client correnti, vedere gh skill install.

Installa con la cross-agent skills CLI

In alternativa, installare la skill con la CLI cross-agent skills:

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

Esaminare gli agenti di coding supportati della CLI e i requisiti di runtime prima dell'installazione.

Usa l'abilità

Interagisci con l'agente di coding in modo naturale. I client compatibili individuano e attivano la skill dai relativi metadati; non presupporre un comando slash universale.

Prompt di esempio:

  • Build a .NET 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 todos, file access, and safe shell tooling.
  • Review this .NET Agent Framework application for current APIs and package requirements.
  • Prepare this Agent Framework agent for hosting in ASP.NET Core and add an evaluation plan.

Includi vincoli come il provider di modelli, la destinazione di hosting, i requisiti di persistenza, i limiti di sicurezza e la versione di destinazione .NET quando li si conoscono.

Cosa deve fare l'agente di codifica

L'abilità indica a un agente di codifica di:

  • Esaminare la soluzione esistente, inclusi i framework di destinazione, la versione dell'SDK, la gestione dei pacchetti e i pacchetti installati Microsoft.Agents.AI.* .
  • Scegliere il pattern più piccolo adatto, ad esempio un agente normale, harness, flusso di lavoro, orchestrazione o definizione dichiarativa.
  • Caricare solo i riferimenti attivi pertinenti.
  • Aggiungere solo il set ristretto di pacchetti necessari all'applicazione e verificare la maturità di ogni pacchetto prima di dipendere da esso, perché alcuni pacchetti sono in versione preliminare.
  • Leggere endpoint, modelli e chiavi dalla configurazione e preferire le credenziali del token rispetto alle chiavi API hardcoded.
  • Verificare l'applicazione generata con i test esistenti del repository e con esempi pronti per l'esecuzione.

La competenza non garantisce che il codice generato sia pronto per la produzione. Esaminare il piano dell'agente di codifica, le scelte dei pacchetti, i limiti di sicurezza, i comandi e le modifiche generate prima dell'approvazione.

Gestione delle versioni e fiducia

La skill è una skill consumer pubblica, installabile e gestita da Microsoft. La versione dei metadati della skill è 0.1.

  • Usare il @main ref fino a quando una versione con tag non include la skill.
  • Visualizza in anteprima il contenuto della competenza prima dell'installazione e rivedi gli aggiornamenti prima di considerare attendibili nuovi script o istruzioni.

Per i riferimenti alla fonte e a quelli specifici, vedere:

Passaggi successivi

Creare il primo agente

Approfondimento:

La skill di creazione di Microsoft Agent Framework per Python, agent-framework-builder-python, offre agli agenti di codifica compatibili linee guida curate da Microsoft per la creazione di soluzioni di Agent Framework per Python. Consente all'agente di coding di scegliere un pattern appropriato e di caricare progressivamente linee guida incentrate sull'attività.

La competenza può guidare il lavoro con:

  • Agenti semplici, provider di modelli, strumenti, approvazioni, sessioni, cronologia e provider di contesto.
  • Sfruttare gli agenti con pianificazione, todos, memoria, compattazione, file, agenti in background, strumenti della shell e cicli.
  • Flussi di lavoro funzionali e grafici, orchestrazioni predefinite e definizioni dichiarative.
  • Valutazione, osservabilità, middleware, client personalizzati, agenti personalizzati e integrazioni.
  • Self-hosting e sviluppo di agenti ospitati in Microsoft Foundry.

La competenza è solo in Python. Fornisce indicazioni sullo sviluppo per un agente di codifica esterno; non è un pacchetto Python, non è installato da pip install agent-frameworke non viene eseguito all'interno dell'applicazione Agent Framework.

Importante

Questa competenza dell'agente di codifica è diversa dalle competenze dell'agente di runtime. Le competenze di runtime vengono caricate da un agente di Agent Framework durante l'esecuzione dell'applicazione. La competenza builder consente a un agente di codifica di creare o modificare il codice sorgente dell'applicazione.

Tip

Associare la builder skill al Microsoft Learn MCP Server. La competenza fornisce all'agente di codifica indicazioni mirate sul flusso di lavoro e sull'implementazione di Agent Framework, mentre Learn MCP Server consente di eseguire ricerche nella documentazione Microsoft aggiornata, recuperare gli articoli completi e trovare esempi di codice durante l'attività. Configurare questo endpoint HTTP pubblico e non autenticato streamable in un agente di codifica compatibile:

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

Prerequisiti

  • Agente di codifica che supporta la specifica open Agent Skills.
  • GitHub CLI con i comandi di anteprima gh skill, oppure Node.js 22.20 o versione successiva se si usa la CLI cross-agent skills.
  • Python 3.11 o versione successiva per le nuove applicazioni di Agent Framework. Agent Framework 1.23 continua a supportare Python 3.10, ma Python 3.10 ha raggiunto la fine del ciclo di vita upstream.

La gestione skill di GitHub CLI è in anteprima e soggetta a modifiche.

Esaminare e installare con GitHub CLI

Visualizzare in anteprima la skill rilasciata prima di installarla:

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

Installare la versione con tag più recente:

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

Blocca la versione Python 1.23 quando sono necessarie indicazioni riproducibili:

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

L'installazione predefinita è con ambito progetto e ha come destinazione GitHub Copilot in uso non interattivo. Selezionare un altro agente di codifica supportato o ambito utente quando necessario:

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

Per le opzioni di ambito e client correnti, vedere gh skill install.

Installa con la cross-agent skills CLI

In alternativa, installare la skill con la CLI cross-agent skills:

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

Esaminare gli agenti di coding supportati della CLI e i requisiti di runtime prima dell'installazione.

Usa l'abilità

Interagisci con l'agente di coding in modo naturale. I client compatibili individuano e attivano la skill dai relativi metadati; non presupporre un comando slash universale.

Prompt di esempio:

  • 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.

Includi vincoli come il provider di modelli, la destinazione di hosting, i requisiti di persistenza, il perimetro di sicurezza e la versione di Python supportata quando li conosci.

Cosa deve fare l'agente di codifica

L'abilità indica a un agente di codifica di:

  • Scegliere il pattern più piccolo adatto, ad esempio un agente normale, harness, flusso di lavoro, orchestrazione o definizione dichiarativa.
  • Caricare solo i riferimenti attivi pertinenti.
  • Preferisci le linee guida correnti di Microsoft Learn, i riferimenti alle API pubbliche, le informazioni sul ciclo di vita dei pacchetti e gli esempi gestiti per i dettagli soggetti a modifiche.
  • Installare set di pacchetti ristretti anziché presumere che ogni integrazione sia stabile o necessaria.
  • Mantenere i limiti espliciti di sessione, approvazione, autenticazione e hosting.
  • Convalidare l'applicazione generata con i test esistenti del repository, i controlli dei tipi e gli esempi eseguibili.

La competenza non garantisce che il codice generato sia pronto per la produzione. Esaminare il piano dell'agente di codifica, le scelte dei pacchetti, i limiti di sicurezza, i comandi e le modifiche generate prima dell'approvazione.

Gestione delle versioni e fiducia

La skill è una skill consumer pubblica, installabile, gestita da Microsoft, rilasciata nel tag del repository python-1.23.0. La versione dei metadati della skill è 0.3.

  • Usare il comando install non qualificato per la versione con tag più recente.
  • Fissa @python-1.23.0 quando la riproducibilità è importante.
  • Usare @main solo quando si vogliono intenzionalmente linee guida non rilasciate.
  • Visualizza in anteprima il contenuto della competenza prima dell'installazione e rivedi gli aggiornamenti prima di considerare attendibili nuovi script o istruzioni.

Per i riferimenti alla fonte e a quelli specifici, vedere:

Passaggi successivi

Creare il primo agente

Approfondimento:

Note

Non è ancora disponibile una skill builder di Microsoft Agent Framework per Go. Usare il tutorial introduttivo di Go e gli esempi di Agent Framework Go per le indicazioni correnti.

  • Ultimo aggiornamento: