Twórz aplikacje platformy Agent Framework przy użyciu agenta kodowania

Umiejętność Builder dla Microsoft Agent Framework dla platformy .NET, agent-framework-builder-dotnet, zapewnia zgodnym agentom kodującym wskazówki utrzymywane przez firmę Microsoft dotyczące tworzenia rozwiązań Microsoft Agent Framework dla platformy .NET (C#). Pomaga agentowi kodowania wybrać odpowiedni wzorzec i stopniowo ładować ukierunkowane wskazówki dotyczące zadania.

Ta umiejętność może pomóc w pracy z:

  • Zwykli agenci, dostawcy modeli, narzędzia, sesje, historia, dostawcy kontekstu i oprogramowanie pośredniczące.
  • Korzystaj z agentów z todos, trybów, pamięci, zatwierdzeń, umiejętności, agentów w tle, narzędzi powłoki, kompaktowania i pętli.
  • Przepływy pracy i wbudowane orkiestracje oraz definicje deklaratywne.
  • Ocena, możliwość obserwowania, klienci niestandardowi, agenci niestandardowi i integracje.
  • Hosting i wdrażanie.

Umiejętność zapewnia wskazówki dotyczące tworzenia dla zewnętrznego agenta kodowania. Nie jest to pakiet NuGet i nie działa w aplikacji Agent Framework.

Important

Ta umiejętność coding-agenta różni się od umiejętności agenta Runtime. Umiejętności runtime są ładowane przez agenta platformy Agent Framework podczas uruchamiania aplikacji. Umiejętność Buildera ułatwia agentowi programistycznemu tworzenie lub modyfikowanie kodu źródłowego aplikacji.

Tip

Połącz umiejętność narzędzia Builder z Microsoft Learn MCP Server. Skill zapewnia agentowi kodowania ukierunkowane wskazówki dotyczące przepływu pracy i implementacji w ramach Agent Framework, a serwer Learn MCP umożliwia wyszukiwanie bieżącej dokumentacji Microsoft, pobieranie kompletnych artykułów i znajdowanie przykładów kodu podczas zadania. Skonfiguruj ten publiczny, nieuwierzytelniony punkt końcowy HTTP z możliwością przesyłania strumieniowego w zgodnym agencie programistycznym:

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

Wymagania wstępne

  • Agent kodowania obsługujący otwartą specyfikację Agent Skills.
  • GitHub CLI z poleceniami w wersji zapoznawczej gh skill lub Node.js 22.20 lub nowszym, jeśli używasz CLI między agentami skills.
  • Obecnie obsługiwany zestaw SDK .NET dla nowych aplikacji platformy Agent Framework.

Zarządzanie umiejętnościami GitHub CLI jest w wersji zapoznawczej i może ulec zmianie.

Przejrzyj i zainstaluj za pomocą GitHub CLI

Umiejętność konstruktora .NET nie znajduje się jeszcze w otagowanym wydaniu, dlatego należy określić @main ref. Wyświetl podgląd umiejętności przed jej zainstalowaniem:

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

Zainstaluj umiejętność:

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

Domyślna instalacja jest ograniczona do projektu i jest przeznaczona dla GitHub Copilot w użyciu nieinterakcyjnym. W razie potrzeby wybierz innego obsługiwanego agenta kodowania lub zakres użytkownika:

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

Aktualne opcje klienta i zakresu znajdują się w gh skill install.

Zainstaluj za pomocą CLI umiejętności między agentami

Alternatywnie zainstaluj umiejętność za pomocą cross-agent skills CLI:

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

Przed instalacją zapoznaj się z obsługiwanymi agentami programistycznymi interfejsu wiersza polecenia i wymaganiami środowiska uruchomieniowego.

Użyj umiejętności

Formułuj polecenia dla agenta kodowania w naturalny sposób. Kompatybilni klienci odnajdą i aktywują umiejętność na podstawie jej metadanych; nie zakładaj uniwersalnej komendy slash.

Przykładowe podpowiedzi:

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

Uwzględnij ograniczenia, takie jak dostawca modelu, docelowe środowisko hostingu, wymagania dotyczące trwałości, granica zabezpieczeń i docelowa wersja platformy .NET, gdy je znasz.

Co powinien zrobić agent kodujący

Funkcja poleca agentowi kodującemu, aby:

  • Sprawdź istniejące rozwiązanie, w tym platformy docelowe, wersję zestawu SDK, zarządzanie pakietami i zainstalowane Microsoft.Agents.AI.* pakiety.
  • Wybierz najmniejszy odpowiedni wzorzec, taki jak zwykły agent, harness, przepływ pracy, orkiestracja lub definicja deklaratywna.
  • Załaduj tylko odpowiednie wybrane odniesienia.
  • Dodaj tylko wąski zestaw pakietów, których potrzebuje aplikacja, i sprawdź dojrzałość każdego pakietu przed poleganiem na nim, ponieważ niektóre pakiety są w wersji wstępnej.
  • Odczytuj punkty końcowe, modele i klucze z konfiguracji oraz preferuj poświadczenia tokenu zamiast trwale zakodowanych kluczy API.
  • Zweryfikuj wygenerowaną aplikację przy użyciu istniejących testów repozytorium i przykładów możliwych do uruchomienia.

Umiejętność nie gwarantuje, że wygenerowany kod jest gotowy do produkcji. Przed zatwierdzeniem przejrzyj plan agenta programistycznego, opcje pakietów, granice zabezpieczeń, polecenia i wygenerowane zmiany.

Wersjonowanie i zaufanie

Ta umiejętność jest publiczną, instalowalną umiejętnością konsumencką utrzymywaną przez firmę Microsoft. Jego wersja metadanych umiejętności to 0.1.

  • Użyj odwołania @main, dopóki otagowane wydanie nie będzie zawierać skilla.
  • Wyświetl podgląd zawartości umiejętności przed instalacją i przejrzyj aktualizacje, zanim zaufasz nowym skryptom lub instrukcjom.

Aby zapoznać się ze źródłowymi i wyróżnionymi odwołaniami, zobacz:

Następne kroki

Tworzenie pierwszego agenta

Głębiej:

Microsoft Agent Framework builder skill for Pythonagent-framework-builder-python zapewnia zgodnym agentom kodowania wskazówki opracowywane przez firmę Microsoft dotyczące tworzenia rozwiązań Python Agent Framework. Pomaga agentowi kodowania wybrać odpowiedni wzorzec i stopniowo ładować ukierunkowane wskazówki dotyczące zadania.

Ta umiejętność może pomóc w pracy z:

  • Zwykli agenci, dostawcy modeli, narzędzia, zatwierdzenia, sesje, historia i dostawcy kontekstu.
  • Wykorzystaj agentów z planowaniem, zadaniami do wykonania, pamięcią, kompaktowaniem, plikami, agentami w tle, narzędziami powłoki i pętlami.
  • Funkcjonalne i grafowe przepływy pracy, wbudowane orkiestracje i definicje deklaratywne.
  • Ocena, obserwowalność, middleware, klienci niestandardowi, agenci niestandardowi i integracje.
  • Samodzielne hostowanie i tworzenie hostowanych agentów Microsoft Foundry.

Ta umiejętność dotyczy tylko Pythona. Zawiera on wskazówki dotyczące tworzenia dla zewnętrznego agenta kodowania; nie jest to pakiet Python, nie jest instalowany przez pip install agent-framework i nie jest uruchamiany w aplikacji Agent Framework.

Important

Ta umiejętność coding-agenta różni się od umiejętności agenta Runtime. Umiejętności runtime są ładowane przez agenta platformy Agent Framework podczas uruchamiania aplikacji. Umiejętność Buildera ułatwia agentowi programistycznemu tworzenie lub modyfikowanie kodu źródłowego aplikacji.

Tip

Połącz umiejętność narzędzia Builder z Microsoft Learn MCP Server. Skill zapewnia agentowi kodowania ukierunkowane wskazówki dotyczące przepływu pracy i implementacji w ramach Agent Framework, a serwer Learn MCP umożliwia wyszukiwanie bieżącej dokumentacji Microsoft, pobieranie kompletnych artykułów i znajdowanie przykładów kodu podczas zadania. Skonfiguruj ten publiczny, nieuwierzytelniony punkt końcowy HTTP z możliwością przesyłania strumieniowego w zgodnym agencie programistycznym:

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

Wymagania wstępne

  • Agent kodowania obsługujący otwartą specyfikację Agent Skills.
  • GitHub CLI z poleceniami w wersji zapoznawczej gh skill lub Node.js 22.20 lub nowszym, jeśli używasz CLI między agentami skills.
  • Python 3.11 lub nowszy. Agent Framework 1.24 nie obsługuje już ani nie testuje języka Python 3.10, chociaż metadane pakietu nadal zezwalają na instalację.

Zarządzanie umiejętnościami GitHub CLI jest w wersji zapoznawczej i może ulec zmianie.

Przejrzyj i zainstaluj za pomocą GitHub CLI

Wyświetl podgląd opublikowanej umiejętności przed jej zainstalowaniem:

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

Zainstaluj najnowszą wersję oznaczoną tagiem:

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

Przypnij wydanie Python 1.23, gdy potrzebujesz powtarzalnych wskazówek:

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

Domyślna instalacja jest ograniczona do projektu i jest przeznaczona dla GitHub Copilot w użyciu nieinterakcyjnym. W razie potrzeby wybierz innego obsługiwanego agenta kodowania lub zakres użytkownika:

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

Aktualne opcje klienta i zakresu znajdują się w gh skill install.

Zainstaluj za pomocą CLI umiejętności między agentami

Alternatywnie zainstaluj umiejętność za pomocą cross-agent skills CLI:

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

Przed instalacją zapoznaj się z obsługiwanymi agentami programistycznymi interfejsu wiersza polecenia i wymaganiami środowiska uruchomieniowego.

Użyj umiejętności

Formułuj polecenia dla agenta kodowania w naturalny sposób. Kompatybilni klienci odnajdą i aktywują umiejętność na podstawie jej metadanych; nie zakładaj uniwersalnej komendy slash.

Przykładowe podpowiedzi:

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

Uwzględnij ograniczenia, takie jak dostawca modelu, docelowe środowisko hostingu, wymagania dotyczące trwałości, granica zabezpieczeń i obsługiwana wersja Python, gdy je znasz.

Co powinien zrobić agent kodujący

Funkcja poleca agentowi kodującemu, aby:

  • Wybierz najmniejszy odpowiedni wzorzec, taki jak zwykły agent, harness, przepływ pracy, orkiestracja lub definicja deklaratywna.
  • Załaduj tylko odpowiednie wybrane odniesienia.
  • Preferuj korzystanie z bieżących wskazówek Microsoft Learn, dokumentacji publicznego interfejsu API, informacji o cyklu życia pakietu i obsługiwanych przykładów w przypadku często zmieniających się szczegółów.
  • Zainstaluj wąskie zestawy pakietów zamiast zakładać, że każda integracja jest stabilna lub wymagana.
  • Zachowaj jawnie określone granice sesji, zatwierdzania, uwierzytelniania i środowiska hostingowego.
  • Zweryfikuj wygenerowaną aplikację przy użyciu istniejących testów repozytorium, kontroli typów i przykładów możliwych do uruchomienia.

Umiejętność nie gwarantuje, że wygenerowany kod jest gotowy do produkcji. Przed zatwierdzeniem przejrzyj plan agenta programistycznego, opcje pakietów, granice zabezpieczeń, polecenia i wygenerowane zmiany.

Wersjonowanie i zaufanie

Skill jest publicznym, instalowalnym, utrzymywanym przez Microsoft skillem dla klientów wydanym w tagu repozytorium python-1.23.0. Jego wersja metadanych umiejętności to 0.3.

  • Użyj polecenia install bez dodatkowego kwalifikatora dla najnowszej oznakowanej wersji.
  • Przypnij @python-1.23.0, gdy ma znaczenie powtarzalność.
  • Używaj @main tylko wtedy, gdy celowo chcesz użyć nieopublikowanych wskazówek.
  • Wyświetl podgląd zawartości umiejętności przed instalacją i przejrzyj aktualizacje, zanim zaufasz nowym skryptom lub instrukcjom.

Aby zapoznać się ze źródłowymi i wyróżnionymi odwołaniami, zobacz:

Następne kroki

Tworzenie pierwszego agenta

Głębiej:

Note

Umiejętność konstruktora Microsoft Agent Framework dla języka Go nie jest jeszcze dostępna. Aby uzyskać bieżące wskazówki, skorzystaj z samouczka wprowadzającego Go i przykładów Agent Framework Go.

  • Ostatnia aktualizacja o