Aracılığıyla paylaş

Microsoft Agent Framework Hızlı Başlangıç Kılavuzu

Bu kılavuz, Agent Framework ve Azure OpenAI kullanarak temel bir aracıyla hızlı bir şekilde çalışmaya başlamanıza yardımcı olur.

Önkoşullar

Başlamadan önce aşağıdakilere sahip olduğunuzdan emin olun:

Uyarı

Microsoft Agent Framework, .NET'in etkin olarak desteklenen tüm sürümleriyle desteklenir. Bu örneğin amaçları doğrultusunda .NET 8 SDK'sını veya sonraki bir sürümü öneririz.

Uyarı

Bu tanıtımda kimlik doğrulaması için Azure CLI kimlik bilgileri kullanılır. ile az login oturum açtığınızdan ve Azure OpenAI kaynağına erişiminiz olduğundan emin olun. Daha fazla bilgi için Azure CLI belgelerine bakın. Api anahtarınız varsa ve rol tabanlı kimlik doğrulaması kullanmak istemiyorsanız ile değiştirmek AzureCliCredentialApiKeyCredential de mümkündür; bu durumda az login gerekli değildir.

Proje oluştur

dotnet new console -o AgentFrameworkQuickStart
cd AgentFrameworkQuickStart

Paketleri Yükleme

Paketler NuGet Galerisi'nde yayımlanacak | MicrosoftAgentFramework.

İlk olarak, aşağıdaki komutları kullanarak aşağıdaki Microsoft Agent Framework NuGet paketlerini uygulamanıza ekleyin:

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

Temel Ajan Örneği Çalıştırma

Bu örnekte arka uç olarak Azure OpenAI Sohbet Tamamlama ile basit bir yapay zeka aracısının nasıl oluşturulacağı ve kullanılacağı gösterilmektedir. Bu, AzureOpenAIClient ve gpt-4o-mini ile özel talimatlar kullanarak temel bir aracı oluşturacaktır.

Örnek Kod

Emin olun ki https://your-resource.openai.azure.com/ değerini Azure OpenAI kaynağınızın uç noktasıyla değiştirin.

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")
    .CreateAIAgent(instructions: "You are good at telling jokes.");

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

(İsteğe bağlı) Gecelik Paketleri Yükleme

En son iyileştirmeleri veya düzeltmeleri içeren bir paket almanız gerekiyorsa, Agent Framework'ün gecelik derlemelerini adresinde https://github.com/orgs/microsoft/packages?repo_name=agent-frameworkbulabilirsiniz.

Gecelik derlemeleri indirmek için şu adımları izleyin:

  1. Bu adımları tamamlamak için bir GitHub hesabına ihtiyacınız olacaktır.

  2. Bu read:packages kullanarak kapsamına sahip bir GitHub Kişisel Erişim Belirteci oluşturun.

  3. Hesabınız Microsoft kuruluşunun bir parçasıysa, kuruluşu çoklu oturum açma kuruluşu olarak yetkilendirmeniz Microsoft gerekir.

    1. Yeni oluşturduğunuz Kişisel Erişim Belirtecinin yanındaki "SSO'ları Yapılandır"a tıklayın ve yetki verin Microsoft.

  4. NuGet yapılandırmanıza Microsoft GitHub Packages kaynağını eklemek için aşağıdaki komutu kullanın:

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

  5. Ya da el ile dosya NuGet.Config oluşturabilirsiniz.

    <?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>
    • Bu dosyayı proje klasörünüze yerleştirirseniz, Git'in (veya kullandığınız versiyon kontrol sisteminin) onu yoksayacağından emin olun.
    • Bu dosyanın depolandığı yer hakkında daha fazla bilgi için bkz. nuget.config başvuru.

  6. Artık gece derlemesinden projenize paket ekleyebilirsiniz.

    Örneğin, bu komutu kullanın dotnet add package Microsoft.Agents.AI --prerelease

  7. Projede en son paket sürümüne şu şekilde referans verebilirsiniz:

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

Daha fazla bilgi için bkz. https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry.

Önkoşullar

Başlamadan önce aşağıdakilere sahip olduğunuzdan emin olun:

pip install -U agent-framework --pre

Uyarı

agent-framework kurulduğunda, agent-framework-core ve diğer tüm resmi paketler de yüklenir. Yalnızca Azure AI paketini yüklemek istiyorsanız şunu çalıştırabilirsiniz: pip install agent-framework-azure-ai --pre Resmi paketlerin hepsinde agent-framework-core bağımlılığı vardır, bu nedenle çoğu durumda bunu özellikle belirtmenize gerek yoktur. Resmi paketlerin tam listesi Agent Framework GitHub deposunda bulunabilir.

Uyarı

Bu örnek, kimlik doğrulaması için Azure CLI kimlik bilgilerini kullanır. Ile az login oturum açtığınızdan ve Azure AI projesine erişiminiz olduğundan emin olun. Daha fazla bilgi için Azure CLI belgelerine bakın.

Temel Ajan Örneği Çalıştırma

Bu örnekte arka uç olarak Azure AI ile basit bir yapay zeka aracısı oluşturma ve kullanma işlemleri gösterilmektedir. Bu, ChatAgent ve AzureAIAgentClient ile özel talimatlar kullanarak temel bir aracı oluşturacaktır.

Aşağıdaki ortam değişkenlerini ayarladığınızdan emin olun:

  • AZURE_AI_PROJECT_ENDPOINT: Azure AI proje uç noktanız
  • AZURE_AI_MODEL_DEPLOYMENT_NAME: Model dağıtımınızın adı

Örnek Kod

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).create_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())

Diğer Örnekler

Daha ayrıntılı örnekler ve gelişmiş senaryolar için bkz. Azure AI Örnekleri.

Sonraki Adımlar

Aracı oluşturma ve çalıştırma

  • Last updated on