Microsoft Aracı Çerçevesi ajan türleri

Microsoft Agent Framework, farklı kullanım örneklerini ve gereksinimlerini karşılamak için çeşitli aracı türleri için destek sağlar.

Tüm aracılar, AIAgenttüm aracı türleri için tutarlı bir arabirim sağlayan ortak bir temel sınıftan türetilir. Bu, çoklu ajan orkestrasyonları gibi ortak, aracı bağımsız ve daha üst düzey işlevler oluşturmaya olanak tanır.

Tüm aracılar, Agenttüm aracı türleri için tutarlı bir arabirim sağlayan ortak bir temel sınıftan türetilir. Bu, çoklu ajan orkestrasyonları gibi ortak, aracı bağımsız ve daha üst düzey işlevler oluşturmaya olanak tanır.

Varsayılan Aracı Çalışma Zamanı Yürütme Modeli

Microsoft Agent Framework'teki tüm aracılar yapılandırılmış bir çalışma zamanı modeli kullanılarak yürütülür. Bu model, belirleyici bir döngüde kullanıcı etkileşimlerini, model çıkarımlarını ve araç yürütmeyi koordine eder.

AI Aracısı Diyagramı

Önemli

Üçüncü taraf sunucularla, aracılarla, kodlarla veya Azure Olmayan Doğrudan modellerle ("Üçüncü Taraf Sistemleri") çalışan uygulamalar oluşturmak için Microsoft Agent Framework kullanıyorsanız, bunu kendi riskinizle yaparsınız. Üçüncü Taraf Sistemler, Microsoft Ürün Koşulları kapsamında Microsoft Olmayan Ürünlerdir ve kendi üçüncü taraf lisans koşullarına tabidir. Kullanım ve ilişkili maliyetlerden siz sorumlusunuz.

Üçüncü Taraf Sistemlerle paylaşılan ve alınan tüm verileri gözden geçirmenizi ve verilerin işlenmesi, paylaşılması, saklanması ve konumuna yönelik üçüncü taraf uygulamaları konusunda bilgili olmanızı öneririz. Verilerinizin kuruluşunuzun Azure uyumluluk ve coğrafi sınırları dışında akıp akmayacağını ve ilgili etkileri ve uygun izinlerin, sınırların ve onayların sağlanıp sağlanmayacağını yönetmek sizin sorumluluğunuzdadır.

Microsoft Agent Framework kullanarak oluşturduğunuz uygulamaları belirli kullanım örnekleri bağlamında dikkatle gözden geçirmek ve test etmek ve tüm uygun kararları ve özelleştirmeleri yapmak sizin sorumluluğunuzdadır. Bu, metaprompt, içerik filtreleri veya diğer güvenlik sistemleri gibi sorumlu yapay zeka risk azaltmalarınızı uygulamayı ve uygulamalarınızın uygun kalite, güvenilirlik, güvenlik ve güvenilirlik standartlarını karşılamasını sağlamayı içerir. Ayrıca bkz: Saydamlık hakkında SSS

Çıkarım hizmetlerini temel alan basit aracılar

Agent Framework, birçok farklı çıkarım hizmetini temel alan basit aracılar oluşturmayı kolaylaştırır. bu aracıları oluşturmak için Microsoft.Extensions.AI.IChatClient uygulaması sağlayan herhangi bir çıkarım hizmeti kullanılabilir. Microsoft.Agents.AI.ChatClientAgent, herhangi bir IChatClient uygulaması için aracı sağlamak için kullanılan aracı sınıfıdır.

Bu ajanlar, kutusundan çıktığı anda kullanılabilen geniş bir işlevsellik yelpazesini destekler.

  1. İşlev çağrısı.
  2. Yerel sohbet geçmişi yönetimi veya hizmet tarafından sağlanan sohbet geçmişi yönetimi ile çok aşamalı konuşmalar.
  3. Özel hizmet tarafından sağlanan araçlar (örneğin, MCP, Kod Yürütme).
  4. Yapılandırılmış veri çıkışları.

Bu aracılardan birini oluşturmak için, seçtiğiniz uygulamayı kullanarak ChatClientAgent bir IChatClient oluşturmanız yeterlidir.

using Microsoft.Agents.AI;

var agent = new ChatClientAgent(chatClient, instructions: "You are a helpful assistant");

Bu aracıları oluşturmayı daha da kolaylaştırmak için, Agent Framework birçok popüler hizmet için yardımcılar sağlar. Daha fazla bilgi için her hizmetin belgelerine bakın.

Temel çıkarım hizmeti Description Desteklenen hizmet sohbeti geçmişinin saklanması InMemory/Özel sohbet geçmişi depolaması destekleniyor
Microsoft Foundry Agent Arka plan olarak Foundry Aracı Hizmeti'ni kullanan bir temsilci. Evet Hayı
Foundry Models SohbetTamamlama ChatCompletion aracılığıyla arka uç olarak Foundry Hizmeti'nde dağıtılan modellerden herhangi birini kullanan bir aracı. Hayı Evet
DökümHane Modelleri Yanıtları Foundry Hizmeti'nde dağıtılmış modellerden herhangi birini, Yanıtlar aracılığıyla arka uç olarak kullanan bir ajan. Evet Evet
Foundry Anthropic Arka uç olarak Foundry Antropik Hizmeti aracılığıyla Claude modeli kullanan bir aracı. Hayı Evet
Azure OpenAI ChatCompletion Azure OpenAI ChatCompletion hizmetini kullanan bir aracı. Hayı Evet
Azure OpenAI Yanıtları Azure OpenAI Yanıtlar hizmetini kullanan bir aracı. Evet Evet
Anthropic Arka ucu Olarak Antropik Hizmet aracılığıyla Claude modeli kullanan bir aracı. Hayı Evet
OpenAI ChatCompletion OpenAI ChatCompletion hizmetini kullanan bir aracı. Hayı Evet
OpenAI Yanıtları OpenAI Yanıtlar hizmetini kullanan bir ajan. Evet Evet
Diğer IChatClient Aracı oluşturmak için başka bir Microsoft.Extensions.AI.IChatClient uygulaması da kullanabilirsiniz. Varies Varies

Karmaşık özel ajanlar

Ayrıca, yalnızca bir IChatClientçevresinde sarmalayıcı olmayan tamamen özel aracılar oluşturmak da mümkündür. Aracı çerçevesi AIAgent temel türünü sağlar. Bu temel tür, alt sınıflandırıldığında aracının davranışı ve özellikleri üzerinde tam denetim sağlayan tüm aracılar için temel soyutlamadır.

Daha fazla bilgi için Özel Aracılar belgelerine bakın.

Uzak aracılar için proxy'ler

Agent Framework, A2A gibi ortak hizmet barındırılan aracı protokolleri için kullanıma AIAgent hazır uygulamalar sağlar. Bu şekilde, uygulamanızdaki uzak aracılara kolayca bağlanabilir ve bunları kullanabilirsiniz.

Daha fazla bilgi için her aracı türünün belgelerine bakın:

Protokol Description
A2A A2A protokolü aracılığıyla uzak bir aracıya proxy görevi gören bir ajan.

Azure ve OpenAI SDK Seçenekleri Referansı

Foundry, Azure OpenAI, OpenAI hizmetleri veya Antropik hizmetleri kullanırken, bu hizmetlere bağlanmak için çeşitli SDK seçenekleriniz vardır. Bazı durumlarda, aynı hizmete bağlanmak için birden çok SDK kullanmak veya farklı hizmetlere bağlanmak için aynı SDK'yı kullanmak mümkündür. Burada, her birine bağlanırken kullanmanız gereken URL ile kullanılabilen farklı seçeneklerin listesi yer alır. <resource> ve <project> etiketlerini gerçek kaynak ve proje adlarınızla değiştirdiğinizden emin olun.

Yapay zeka hizmeti SDK Nuget Bağlantı
Dökümhane Modelleri Azure OpenAI SDK 2 Azure. AI. OpenAI https://ai-foundry-<resource.services.ai.azure.com/>
Dökümhane Modelleri OpenAI SDK 3 OpenAI https://ai-foundry-<resource.services.ai.azure.com/openai/v1/>
Dökümhane Modelleri Azure AI Çıkarım SDK'sı 2 Azure.AI.Çıkarsama https://ai-foundry-<resource.services.ai.azure.com/models>
Döküm Aracıları Azure AI Projeleri SDK'sı + Microsoft Ajanları Yapay Zeka Dökkânı Azure.AI.Projects / Microsoft.Agents.AI.Foundry https://ai-foundry-<resource.services.ai.azure.com/api/projects/ai-project-project><>
Azure OpenAI1 Azure OpenAI SDK 2 Azure. AI. OpenAI <https:// resource.openai.azure.com/>
Azure OpenAI1 OpenAI SDK'sı OpenAI <https://resource.openai.azure.com/openai/v1/>
OpenAI OpenAI SDK'sı OpenAI URL gerekmez
Microsoft Foundry Anthropic Antropik Foundry SDK Anthropic.Foundry Kaynak adı gerekli
Anthropic Antropik SDK Anthropic Url veya kaynak adı gerekmez
  1. Azure OpenAI'den Foundry
  2. OpenAI SDK'sını kullanmanızı öneririz.
  3. Foundry modellerine erişmek için OpenAI SDK'sını kullanmanızı önersek de, Foundry Modelleri yalnızca OpenAI'nin değil birçok farklı satıcının modellerini destekler. Tüm bu modeller OpenAI SDK'sı aracılığıyla desteklenir.

OpenAI SDK'sını kullanma

Yukarıdaki tabloda gösterildiği gibi, OpenAI SDK'sı birden çok hizmete bağlanmak için kullanılabilir. Bağlandığınız hizmete bağlı olarak, OpenAIClient oluştururken özel bir URL ayarlamanız gerekebilir. Hizmete bağlı olarak farklı kimlik doğrulama mekanizmaları da kullanabilirsiniz.

Özel bir URL gerekiyorsa (yukarıdaki tabloya bakın), OpenAIClientOptions aracılığıyla ayarlayabilirsiniz.

var clientOptions = new OpenAIClientOptions() { Endpoint = new Uri(serviceUrl) };

İstemciyi oluştururken bir API anahtarı kullanmak mümkündür.

OpenAIClient client = new OpenAIClient(new ApiKeyCredential(apiKey), clientOptions);

Azure Hizmeti kullanırken API anahtarı yerine Azure kimlik bilgilerini kullanmak da mümkündür.

OpenAIClient client = new OpenAIClient(new BearerTokenPolicy(new DefaultAzureCredential(), "https://ai.azure.com/.default"), clientOptions)

Uyarı

DefaultAzureCredential geliştirme için uygundur ancak üretimde dikkatli bir şekilde dikkate alınması gerekir. Üretimde gecikme sorunları, istenmeyen kimlik bilgisi yoklama ve geri dönüş mekanizmalarından kaynaklanan olası güvenlik risklerini önlemek için belirli bir kimlik bilgisi (ör ManagedIdentityCredential. ) kullanmayı göz önünde bulundurun.

OpenAIClient'ı oluşturduktan sonra, kullanmak istediğiniz belirli bir hizmet için bir alt istemci alabilir ve ardından bu hizmetten bir AIAgent alt istemci oluşturabilirsiniz.

AIAgent agent = client
    .AsAIAgent(model: model, instructions: "You are good at telling jokes.", name: "Joker");

Azure AI Projeleri SDK'sını kullanma

Bu SDK, Foundry hizmetlerine bağlanmak için kullanılabilir. oluştururken doğru proje uç noktası URL'sini AIProjectClientsağlamanız gerekir. Kullanılacak doğru URL için yukarıdaki tabloya bakın.

AIAgent agent = new AIProjectClient(
    new Uri(serviceUrl),
    new DefaultAzureCredential())
     .AsAIAgent(
         model: deploymentName,
         instructions: "You are good at telling jokes.",
         name: "Joker");

Azure AI Projeleri SDK'sını Döküm Aracıları ile kullanma

Bu SDK hem YanıtLAR API tabanlı aracılar hem de sürümlenmiş Döküm Aracıları için kullanılır. Kullanılacak doğru URL için yukarıdaki tabloya bakın.

var aiProjectClient = new AIProjectClient(new Uri(serviceUrl), new DefaultAzureCredential());
AIAgent agent = aiProjectClient.AsAIAgent(
    model: deploymentName,
    instructions: "You are good at telling jokes.",
    name: "Joker");

Foundry Anthropic SDK'sini kullanma

Kaynak, uç nokta URI'sinde '.services.ai.azure.com' öncesinde gelen alt etki alanı adı / adıdır.

Örneğin: https://(resource name).services.ai.azure.com/anthropic/v1/chat/completions

var client = new AnthropicFoundryClient(new AnthropicFoundryApiKeyCredentials(apiKey, resource));
AIAgent agent = client.AsAIAgent(
    model: deploymentName,
    instructions: "Joker",
    name: "You are good at telling jokes.");

Antropik SDK'sını kullanma

var client = new AnthropicClient() { ApiKey = apiKey };
AIAgent agent = client.AsAIAgent(
    model: deploymentName,
    instructions: "Joker",
    name: "You are good at telling jokes.");

Çıkarım hizmetlerini temel alan basit aracılar

Agent Framework, birçok farklı çıkarım hizmetini temel alan basit aracılar oluşturmayı kolaylaştırır. Bu aracıları oluşturmak için sohbet istemcisi uygulaması sağlayan herhangi bir çıkarım hizmeti kullanılabilir. Bu, istemcinin standart SupportsChatGetResponse sınıfla kullanılabilmesi için desteklemesi gereken yöntemleri tanımlayan Agent protokolü kullanılarak yapılabilir.

Bu ajanlar, kutusundan çıktığı anda kullanılabilen geniş bir işlevsellik yelpazesini destekler.

  1. Fonksiyon çağırma
  2. Yerel sohbet geçmişi yönetimi veya hizmet tarafından sağlanan sohbet geçmişi yönetimi ile çok aşamalı konuşmalar
  3. Özel hizmet tarafından sağlanan araçlar (örneğin, MCP, Kod Yürütme)
  4. Yapılandırılmış çıkışlar
  5. Akış yanıtları

Bu aracılardan birini oluşturmak için istediğiniz sohbet istemcisi uygulamasını kullanarak bir Agent oluşturmanız yeterlidir.

import os
from agent_framework import Agent
from agent_framework.foundry import FoundryChatClient
from azure.identity.aio import DefaultAzureCredential

agent = Agent(
    client=FoundryChatClient(
        credential=DefaultAzureCredential(),
        project_endpoint=os.getenv("FOUNDRY_PROJECT_ENDPOINT"),
        model=os.getenv("FOUNDRY_MODEL"),
    ),
    instructions="You are a helpful assistant",
)
response = await agent.run("Hello!")

Alternatif olarak, sohbet istemcisinde kolaylık yöntemini kullanabilirsiniz:

from agent_framework.foundry import FoundryChatClient
from azure.identity.aio import DefaultAzureCredential

agent = FoundryChatClient(
    credential=DefaultAzureCredential(),
    project_endpoint=os.getenv("FOUNDRY_PROJECT_ENDPOINT"),
    model=os.getenv("FOUNDRY_MODEL"),
).as_agent(
    instructions="You are a helpful assistant"
)

Uyarı

Bu örnekte FoundryChatClient kullanımı gösterilmektedir, ancak aynı desen uygulayan tüm sohbet istemcilerinde SupportsChatGetResponsegeçerlidir. Diğer istemcilerle ilgili daha fazla bilgi için sağlayıcılara genel bakış konusuna bakın.

Ayrıntılı örnekler için aşağıdaki aracıya özgü belgeler bölümlerine bakın.

Desteklenen Sohbet Sağlayıcıları

Temel Çıkarım Hizmeti Description Hizmet Sohbeti Geçmişi depolaması destekleniyor
Döküm Temsilcisi Aracı Hizmeti'ni arka uç olarak kullanan bir aracı. Evet
Azure OpenAI Sohbet Tamamlama Azure OpenAI Sohbet Tamamlama hizmetini kullanan bir aracı. Hayı
Azure OpenAI Yanıtları Azure OpenAI Yanıtlar hizmetini kullanan bir aracı. Evet
OpenAI Sohbet Tamamlama OpenAI Sohbet Tamamlama hizmetini kullanan bir aracı. Hayı
OpenAI Yanıtları OpenAI Yanıtlar hizmetini kullanan bir ajan. Evet
Antropik Claude "Anthropic Claude modellerini kullanan bir ajan." Hayı
Amazon Bedrock Amazon Bedrock modellerini Agent Framework Bedrock sohbet yazılımı aracılığıyla kullanan bir acente. Hayı
GitHub Copilot GitHub Copilot SDK altyapısını kullanan bir aracı. Hayı
Ollama (OpenAI uyumlu) OpenAI uyumlu API'ler aracılığıyla yerel olarak barındırılan Ollama modellerini kullanan bir aracı. Hayı
Diğer Tüm ChatClient'lar Başka herhangi bir SupportsChatGetResponse uygulamasını da bir ajan oluşturmak için kullanabilirsiniz. Varies

Oturum tabanlı konuşma durumu desteklendiğinde özel sohbet geçmişi depolaması desteklenir.

Akış Yanıtları

Ajanlar hem normal hem de akış yanıtlarını destekler.

# Regular response (wait for complete result)
response = await agent.run("What's the weather like in Seattle?")
print(response.text)

# Streaming response (get results as they are generated)
async for chunk in agent.run("What's the weather like in Portland?", stream=True):
    if chunk.text:
        print(chunk.text, end="", flush=True)

Akış örnekleri için bkz:

Daha fazla çağrı deseni için Çalıştırma Aracıları bölümüne bakın.

İşlev Araçları

Gelişmiş özellikler için aracılara işlev araçları sağlayabilirsiniz:

import os
from typing import Annotated
from azure.identity.aio import DefaultAzureCredential
from agent_framework.foundry import FoundryChatClient

def get_weather(location: Annotated[str, "The location to get the weather for."]) -> str:
    """Get the weather for a given location."""
    return f"The weather in {location} is sunny with a high of 25°C."

async with DefaultAzureCredential() as credential:
    agent = FoundryChatClient(
        credential=credential,
        project_endpoint=os.getenv("FOUNDRY_PROJECT_ENDPOINT"),
        model=os.getenv("FOUNDRY_MODEL"),
    ).as_agent(
        instructions="You are a helpful weather assistant.",
        tools=get_weather,
    )
    response = await agent.run("What's the weather in Seattle?")

Araçlar ve araç desenleri için bkz. Araçlara genel bakış.

Özel aracılar

Tamamen özel uygulamalar (örneğin, belirlenimici aracılar veya API destekli aracılar) için bkz. Özel Aracılar. Bu sayfa, SupportsAgentRun uygulamasını veya BaseAgent uzatılmasını, AgentResponseUpdate ile akış güncellemeleri de dahil olmak üzere kapsar.

Diğer ajan türleri

Agent Framework ayrıca aşağıdakiler gibi protokol destekli aracılar içerir:

Ajan Türü Description
A2A Uzak A2A uyumlu aracılara bağlanan ve çağıran bir proxy aracısı.

Sonraki Adımlar

Çalışan Ajanlar

  • Last updated on