Ajan kavramları

Agent Framework ajanı, bir ajan soyutlamasını, bir modeli veya uzak ajan bağlantısını, yönergeleri, araçları, ara yazılımı, bağlam sağlayıcılarını ve oturum durumunu tutarlı bir çalıştırma arayüzü altında birleştirir.

Çalışma zamanı ve yürütme

• Aracıları çalıştırma, normal ve akışlı çalıştırmaları, çalıştırma seçeneklerini, yanıtları, iletileri ve içeriği açıklar.
• Aracı işlem hattı ara yazılımların, bağlam sağlayıcılarının, model çağırmanın ve araçların bir çalıştırmaya nasıl katıldığını açıklar.
• Çalışma zamanı modeli yönlendirmesi , bir konuşmanın bağlamı kaybetmeden modelleri veya çıkarım sağlayıcılarını ne zaman değiştirebileceğini açıklar.

Aracı türleri

• Özel aracılar ortak aracı arabirimini ve bir aracıyı doğrudan ne zaman uygulayacaklarını açıklar.
• Model sağlayıcıları , uygulamaya ait aracıları çıkarım hizmetlerine bağlar.
• Aracı hizmetleri yönetilen veya protokol destekli uzak aracılara bağlanır.

Sohbet istemcisi aracıları

Sohbet istemcisi aracıları, model çıkarımı istemcisi tarafından desteklenen uygulamaya ait aracılardır. İşlev araçlarını, çok turlu konuşmaları, uygun olduğunda sağlayıcı tarafından barındırılan araçları, yapılandırılmış çıktıları, akışı, ara yazılımı ve yerel veya hizmet tarafından yönetilen konuşma geçmişini destekler.

Microsoft.Extensions.AI.IChatClient uygulayan herhangi bir çıkarım istemcisi, bir ChatClientAgent'i destekleyebilir:

using Microsoft.Agents.AI;

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

Tüm aracı uygulamaları aynı AIAgent soyutlamasını paylaşır; bu sayede uygulama kodu ve orkestrasyonlar, sohbet istemcisi aracıları, özel aracılar ve uzak aracı vekilleriyle tek bir arabirim üzerinden çalışabilir.

Sağlayıcı özellikleri, konuşma geçmişi desteği ve SDK uç noktası seçimi için bkz. Model sağlayıcıları.

SupportsChatGetResponse uygulayan herhangi bir istemciden standart bir Agent oluşturun:

from agent_framework import Agent

agent = Agent(
    client=client,
    instructions="You are a helpful assistant.",
)

Desteklenen model sağlayıcıları arasında aynı Agent arabirim çalışır. FoundryAgent, A2AAgent, GitHubCopilotAgent ve ClaudeAgent gibi doğrudan aracı türleri bunun yerine yönetilen veya uzak aracı çalışma zamanlarına bağlanır.

İstemci veya MCP araçları eşzamansız kaynakları yönettiğinde async with agent kullanın. Bağlam yöneticisi bunları otomatik olarak açar ve kapatır. Açık uygulama yaşam döngüsü denetimi için bir kez çağırın open() ve aracıyı bir finally blokta kapatın:

await agent.open()
try:
    response = await agent.run("Hello")
finally:
    await agent.close()

close() ayrıca bir çalıştırma sırasında gevşek bir şekilde bağlanan MCP araçlarını serbest bırakır. open(), başlatma sırasında bir noktada başarısız olursa, aracı önceden açılmış kaynakları kapatır.

Kullanılabilir çıkarım istemcileri için bkz. Model sağlayıcıları.

Go model sağlayıcı paketleri, sağlayıcıya özgü oluşturucular aracılığıyla standart *agent.Agent türü oluşturur. Bu, istemci başlatma işlemi her sağlayıcının sorumluluğundayken, uygulama koduna tutarlı bir çalıştırma, oturum, araç, ara yazılım ve akış arayüzü sağlar.

Oluşturucular ve içeri aktarma yolları için bkz. Model sağlayıcıları.

Konuşmalar ve bellek

Konuşma kavramları oturumları, bağlam sağlayıcılarını, depolamayı, sıkıştırmayı ve yerleşik sohbet geçmişi bellek sağlayıcısını kapsar.

Middleware

Ara yazılım kavramları tanım, kapsam, sıralama, paylaşılan durum, çalışma zamanı bağlamı, sonlandırma, hatalar ve sonuç geçersiz kılmalarını kapsar.

Safety

Aracı güvenliği , aracı davranışını kısıtlamaya ve operasyonel riski azaltmaya yönelik tasarım desenlerini açıklar. FIDES ile güvenlik uygulaması bir Aracı Özelliği olarak kalır.

Sonraki Adımlar

Aracıları çalıştırmayı öğrenin