Bagikan melalui

Microsoft Agent Framework: Panduan Cepat-Mulai

Panduan ini akan membantu Anda memulai dan menjalankan dengan cepat dengan agen dasar menggunakan Agent Framework dan Azure OpenAI.

Prasyarat

Sebelum memulai, pastikan Anda memiliki hal berikut:

Nota

Microsoft Agent Framework didukung dengan semua versi .NET yang didukung secara aktif. Untuk tujuan sampel ini, kami merekomendasikan .NET 8 SDK atau versi yang lebih baru.

Nota

Demo ini menggunakan kredensial Azure CLI untuk autentikasi. Pastikan Anda masuk dengan az login dan memiliki akses ke sumber daya Azure OpenAI. Untuk informasi selengkapnya, lihat dokumentasi Azure CLI. Dimungkinkan juga untuk mengganti AzureCliCredential dengan ApiKeyCredential jika Anda memiliki kunci api dan tidak ingin menggunakan autentikasi berbasis peran, dalam hal az login ini tidak diperlukan.

Membuat proyek

dotnet new console -o AgentFrameworkQuickStart
cd AgentFrameworkQuickStart

Pasang Paket

Paket akan diterbitkan ke Galeri NuGet | MicrosoftAgentFramework.

Pertama, tambahkan paket Microsoft Agent Framework NuGet berikut ke dalam aplikasi Anda, menggunakan perintah berikut:

dotnet add package Azure.AI.OpenAI --prerelease
dotnet add package Azure.Identity
dotnet add package Microsoft.Agents.AI.OpenAI --prerelease

Menjalankan Sampel Agen Dasar

Sampel ini menunjukkan cara membuat dan menggunakan agen AI sederhana dengan Azure OpenAI Chat Completion sebagai backend. Ini akan membuat agen dasar menggunakan AzureOpenAIClient dengan gpt-4o-mini dan instruksi kustom.

Kode Sampel

Pastikan untuk mengganti https://your-resource.openai.azure.com/ dengan titik akhir sumber daya Azure OpenAI Anda.

using System;
using Azure.AI.OpenAI;
using Azure.Identity;
using Microsoft.Agents.AI;
using OpenAI;

AIAgent agent = new AzureOpenAIClient(
  new Uri("https://your-resource.openai.azure.com/"),
  new AzureCliCredential())
    .GetChatClient("gpt-4o-mini")
    .AsAIAgent(instructions: "You are good at telling jokes.");

Console.WriteLine(await agent.RunAsync("Tell me a joke about a pirate."));

(Opsional) Menginstal Paket Malam Hari

Jika Anda perlu mendapatkan paket yang berisi peningkatan atau perbaikan terbaru, build harian Kerangka Kerja Agen tersedia di https://github.com/orgs/microsoft/packages?repo_name=agent-framework.

Untuk mengunduh build malam hari, ikuti langkah-langkah berikut:

  1. Anda akan memerlukan akun GitHub untuk menyelesaikan langkah-langkah ini.

  2. Buat Token Akses Pribadi GitHub dengan read:packages cakupan menggunakan instruksi ini.

  3. Jika akun Anda adalah bagian dari organisasi Microsoft, maka Anda harus mengotorisasi Microsoft organisasi sebagai organisasi single sign-on.

    1. Klik "Konfigurasikan SSO" di samping Token Akses Pribadi yang baru saja Anda buat lalu otorisasi Microsoft.

  4. Gunakan perintah berikut untuk menambahkan sumber Paket Microsoft GitHub ke konfigurasi NuGet Anda:

    dotnet nuget add source --username GITHUBUSERNAME --password GITHUBPERSONALACCESSTOKEN --store-password-in-clear-text --name GitHubMicrosoft "https://nuget.pkg.github.com/microsoft/index.json"

  5. Atau Anda dapat membuat NuGet.Config file secara manual.

    <?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
    <add key="github" value="https://nuget.pkg.github.com/microsoft/index.json" />
  </packageSources>

  <packageSourceMapping>
    <packageSource key="nuget.org">
      <package pattern="*" />
    </packageSource>
    <packageSource key="github">
      <package pattern="*nightly"/>
      <package pattern="Microsoft.Agents.AI" />
    </packageSource>
  </packageSourceMapping>

  <packageSourceCredentials>
    <github>
        <add key="Username" value="<Your GitHub Id>" />
        <add key="ClearTextPassword" value="<Your Personal Access Token>" />
      </github>
  </packageSourceCredentials>
</configuration>
    • Jika Anda menempatkan file ini di folder proyek Anda, pastikan untuk memiliki Git (atau kontrol sumber apa pun yang Anda gunakan) mengabaikannya.
    • Untuk informasi selengkapnya tentang tempat menyimpan file ini, lihat referensinuget.config.

  6. Anda sekarang dapat menambahkan paket dari build harian ke proyek Anda.

    Misalnya, gunakan perintah ini dotnet add package Microsoft.Agents.AI --prerelease

  7. Dan rilis paket terbaru dapat dirujuk dalam proyek seperti ini:

    <PackageReference Include="Microsoft.Agents.AI" Version="*-*" />

Untuk informasi selengkapnya, lihat https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry .

Prasyarat

Sebelum memulai, pastikan Anda memiliki hal berikut:

pip install -U agent-framework --pre

Nota

Menginstal agent-framework akan menginstal agent-framework-core dan semua paket resmi lainnya. Jika Anda hanya ingin menginstal paket Azure AI, Anda dapat menjalankan: pip install agent-framework-azure-ai --pre Semua paket resmi, termasuk agent-framework-azure-ai memiliki dependensi pada agent-framework-core, jadi dalam kebanyakan kasus, Anda tidak perlu menentukannya. Daftar lengkap paket resmi dapat ditemukan di repositori GitHub Agent Framework.

Nota

Sampel ini menggunakan kredensial Azure CLI untuk autentikasi. Pastikan Anda masuk dengan az login dan memiliki akses ke proyek Azure AI. Untuk informasi selengkapnya, lihat dokumentasi Azure CLI.

Menjalankan Sampel Agen Dasar

Sampel ini menunjukkan cara membuat dan menggunakan agen AI sederhana dengan Azure AI sebagai backend. Ini akan membuat agen dasar menggunakan ChatAgent dengan AzureAIAgentClient dan instruksi kustom.

Pastikan untuk mengatur variabel lingkungan berikut:

  • AZURE_AI_PROJECT_ENDPOINT: Titik akhir proyek Azure AI Anda
  • AZURE_AI_MODEL_DEPLOYMENT_NAME: Nama penerapan model Anda

Kode Sampel

import asyncio
from agent_framework.azure import AzureAIClient
from azure.identity.aio import AzureCliCredential

async def main():
    async with (
        AzureCliCredential() as credential,
        AzureAIClient(async_credential=credential).as_agent(
            instructions="You are good at telling jokes."
        ) as agent,
    ):
        result = await agent.run("Tell me a joke about a pirate.")
        print(result.text)

if __name__ == "__main__":
    asyncio.run(main())

Contoh Lainnya

Untuk contoh dan skenario tingkat lanjut yang lebih rinci, lihat Contoh Azure AI.

Langkah selanjutnya

Membuat dan menjalankan agen

  • Last updated on