Membangun aplikasi Agent Framework dengan agen coding

Microsoft Agent Framework builder skill for .NET, agent-framework-builder-dotnet, memberikan agen coding yang kompatibel panduan yang dikelola Microsoft untuk membangun solusi Kerangka Kerja Agen .NET (C#). Ini membantu agen pengkodan memilih pola yang sesuai dan secara progresif memuat panduan yang berfokus untuk tugas tersebut.

Keterampilan ini dapat membantu Anda bekerja dengan:

  • agen plain, penyedia model, alat, sesi, riwayat, penyedia konteks, dan middleware.
  • Manfaatkan agen dengan todo, mode, memori, persetujuan, keterampilan, agen latar belakang, alat shell, pemadatan, dan perulangan.
  • Alur kerja, orkestrasi bawaan, dan definisi deklaratif.
  • Evaluasi, observabilitas, klien kustom, agen kustom, dan integrasi.
  • Hosting dan penyebaran.

Skill ini memberikan panduan pengembangan kepada agen pengodean eksternal. Ini bukan paket NuGet dan tidak dapat dijalankan di dalam aplikasi Agent Framework Anda.

Important

Keterampilan agen coding ini berbeda dari Keterampilan Agen runtime. Skill runtime dimuat oleh agen Agent Framework saat aplikasi Anda berjalan. Builder skill membantu agen pengodean membuat atau memodifikasi kode sumber aplikasi Anda.

Tip

Pasangkan keahlian builder dengan Microsoft Learn MCP Server. Keterampilan ini memberi agen pengkodean yang berfokus pada alur kerja Kerangka Kerja Agen dan panduan implementasi, sementara Learn MCP Server memungkinkannya mencari dokumentasi Microsoft saat ini, mengambil artikel lengkap, dan menemukan sampel kode selama tugas. Konfigurasikan titik akhir HTTP Streamable publik tanpa autentikasi ini di agen pengodean yang kompatibel:

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

Prerequisites

  • Agen pemrograman yang mendukung spesifikasi Agent Skills terbuka.
  • GitHub CLI dengan CLI pratinjau gh skill perintah, atau Node.js 22.20 atau yang lebih baru jika Anda menggunakan perintah lintas agen skills CLI.
  • SDK .NET yang saat ini didukung untuk aplikasi Agent Framework baru.

Pengelolaan keterampilan GitHub CLI sedang dalam pratinjau dan dapat berubah.

Tinjau dan instal dengan CLI GitHub

Builder skill .NET belum ada dalam rilis yang ditandai, jadi Anda perlu menentukan ref @main. Pratinjau skill tersebut sebelum menginstalnya:

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

Instal skill:

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

Penginstalan default bercakupan proyek dan ditujukan untuk GitHub Copilot dalam penggunaan non-interaktif. Pilih agen coding atau cakupan pengguna lain yang didukung saat diperlukan:

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

Untuk opsi klien dan cakupan saat ini, lihat gh skill install.

Instal dengan cross-agent skills CLI

Sebagai alternatif, instal skill dengan CLI lintas agen skills:

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

Tinjau agen pengkodian yang didukung dan persyaratan runtime CLI sebelum penginstalan.

Gunakan keterampilan

Berikan perintah kepada agen coding secara alami. Klien yang kompatibel menemukan dan mengaktifkan keterampilan dari metadatanya; jangan asumsikan perintah garis miring universal.

Contoh perintah:

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

Sertakan batasan seperti penyedia model, target hosting, persyaratan persistensi, batas keamanan, dan versi .NET target saat Anda mengenalnya.

Apa yang harus dilakukan agen coding

Skill ini mengarahkan agen coding untuk:

  • Periksa solusi yang ada, termasuk kerangka kerja target, versi SDK, manajemen paket, dan paket yang diinstalMicrosoft.Agents.AI.*.
  • Pilih pola terkecil yang sesuai, seperti agen biasa, harness, alur kerja, orkestrasi, atau definisi deklaratif.
  • Muat hanya referensi terfokus yang relevan.
  • Tambahkan hanya paket yang benar-benar dibutuhkan aplikasi, dan periksa kematangan setiap paket sebelum bergantung padanya, karena beberapa paket berstatus prarilis.
  • Baca endpoint, model, dan kunci dari konfigurasi, dan utamakan kredensial token daripada kunci API yang dikodekan secara permanen.
  • Validasi aplikasi yang dihasilkan dengan pengujian repositori yang ada dan sampel yang dapat dijalankan.

Keterampilan tidak menjamin bahwa kode yang dihasilkan siap untuk produksi. Tinjau rencana agen pengodean, pilihan paket, batas keamanan, perintah, dan perubahan yang dihasilkan sebelum menyetujui.

Pembuatan versi dan kepercayaan

Keterampilannya adalah keterampilan konsumen yang publik, dapat diinstal, dan dikelola oleh Microsoft. Versi metadata keterampilannya adalah 0.1.

  • @main Gunakan ref hingga rilis yang ditandai menyertakan skill.
  • Pratinjau konten keterampilan sebelum penginstalan dan tinjau pembaruan sebelum mempercayai skrip atau instruksi baru.

Untuk sumber dan referensi terkait, lihat:

Langkah berikutnya

Membuat agen pertama Anda

Masuk lebih dalam:

builder skill Microsoft Agent Framework untuk Python, agent-framework-builder-python, memberikan agen pemrograman yang kompatibel panduan yang dikelola Microsoft untuk membangun solusi Python Agent Framework. Ini membantu agen pengkodan memilih pola yang sesuai dan secara progresif memuat panduan yang berfokus untuk tugas tersebut.

Keterampilan ini dapat membantu Anda bekerja dengan:

  • agen plain, penyedia model, alat, persetujuan, sesi, riwayat, dan penyedia konteks.
  • Manfaatkan agen dengan perencanaan, todos, memori, pemadatan, file, agen latar belakang, alat shell, dan perulangan.
  • Alur kerja fungsional dan graf, orkestrasi bawaan, dan definisi deklaratif.
  • Evaluasi, observabilitas, middleware, klien kustom, agen kustom, dan integrasi.
  • Hosting mandiri dan pengembangan hosted-agent Microsoft Foundry.

Skill ini hanya mendukung Python. Ini memberikan panduan pengembangan untuk agen pengkodian eksternal; ini bukan paket Python, tidak diinstal oleh pip install agent-framework, dan tidak berjalan di dalam aplikasi Agent Framework Anda.

Important

Keterampilan agen coding ini berbeda dari Keterampilan Agen runtime. Skill runtime dimuat oleh agen Agent Framework saat aplikasi Anda berjalan. Builder skill membantu agen pengodean membuat atau memodifikasi kode sumber aplikasi Anda.

Tip

Pasangkan keahlian builder dengan Microsoft Learn MCP Server. Keterampilan ini memberi agen pengkodean yang berfokus pada alur kerja Kerangka Kerja Agen dan panduan implementasi, sementara Learn MCP Server memungkinkannya mencari dokumentasi Microsoft saat ini, mengambil artikel lengkap, dan menemukan sampel kode selama tugas. Konfigurasikan titik akhir HTTP Streamable publik tanpa autentikasi ini di agen pengodean yang kompatibel:

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

Prerequisites

  • Agen pemrograman yang mendukung spesifikasi Agent Skills terbuka.
  • GitHub CLI dengan CLI pratinjau gh skill perintah, atau Node.js 22.20 atau yang lebih baru jika Anda menggunakan perintah lintas agen skills CLI.
  • Python 3.11 atau yang lebih baru. Agent Framework 1.24 tidak lagi mendukung atau menguji Python 3.10, meskipun metadata paket masih mengizinkan penginstalan.

Pengelolaan keterampilan GitHub CLI sedang dalam pratinjau dan dapat berubah.

Tinjau dan instal dengan CLI GitHub

Pratinjau skill yang dirilis sebelum menginstalnya:

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

Instal versi terbaru yang diberi tag:

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

Sematkan rilis Python 1.23 saat Anda memerlukan panduan yang dapat direproduksi:

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

Penginstalan default bercakupan proyek dan ditujukan untuk GitHub Copilot dalam penggunaan non-interaktif. Pilih agen coding atau cakupan pengguna lain yang didukung saat diperlukan:

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

Untuk opsi klien dan cakupan saat ini, lihat gh skill install.

Instal dengan cross-agent skills CLI

Sebagai alternatif, instal skill dengan CLI lintas agen skills:

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

Tinjau agen pengkodian yang didukung dan persyaratan runtime CLI sebelum penginstalan.

Gunakan keterampilan

Berikan perintah kepada agen coding secara alami. Klien yang kompatibel menemukan dan mengaktifkan keterampilan dari metadatanya; jangan asumsikan perintah garis miring universal.

Contoh perintah:

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

Sertakan batasan seperti penyedia model, target hosting, persyaratan persistensi, batas keamanan, dan versi Python yang didukung saat Anda mengetahuinya.

Apa yang harus dilakukan agen coding

Skill ini mengarahkan agen coding untuk:

  • Pilih pola terkecil yang sesuai, seperti agen biasa, harness, alur kerja, orkestrasi, atau definisi deklaratif.
  • Muat hanya referensi terfokus yang relevan.
  • Utamakan panduan Microsoft Learn saat ini, referensi API publik, informasi siklus hidup paket, dan sampel yang dikelola untuk detail volatil.
  • Instal sekumpulan paket yang terbatas alih-alih mengasumsikan setiap integrasi stabil atau diperlukan.
  • Pertahankan batas sesi, persetujuan, autentikasi, dan hosting.
  • Validasi aplikasi yang dihasilkan dengan pengujian repositori yang ada, pemeriksaan tipe, dan sampel yang dapat dijalankan.

Keterampilan tidak menjamin bahwa kode yang dihasilkan siap untuk produksi. Tinjau rencana agen pengodean, pilihan paket, batas keamanan, perintah, dan perubahan yang dihasilkan sebelum menyetujui.

Pembuatan versi dan kepercayaan

Skill ini adalah skill konsumen publik yang dapat diinstal, dikelola oleh Microsoft, dan dirilis pada tag repositori python-1.23.0. Versi metadata keterampilannya adalah 0.3.

  • Gunakan perintah install tanpa kualifikasi untuk rilis bertag terbaru.
  • Sematkan @python-1.23.0 saat reproduktibilitas penting.
  • Gunakan @main hanya ketika Anda sengaja ingin panduan yang belum dirilis.
  • Pratinjau konten keterampilan sebelum penginstalan dan tinjau pembaruan sebelum mempercayai skrip atau instruksi baru.

Untuk sumber dan referensi terkait, lihat:

Langkah berikutnya

Membuat agen pertama Anda

Masuk lebih dalam:

Note

Skill builder Microsoft Agent Framework untuk Go belum tersedia. Gunakan tutorial memulai Go dan contoh Agent Framework Go untuk panduan saat ini.

  • Terakhir diperbarui pada