A2A Ajanları

Microsoft Agent Framework, diğer aracılar ile aynı AIAgent soyutlama kullanılarak uygulamanızda A2A protokolü aracılığıyla kullanıma sunulan bir uzak aracı kullanmayı destekler.

Başlangıç Yapmak

Projenize gerekli NuGet paketlerini ekleyin.

dotnet add package Microsoft.Agents.AI.A2A --prerelease

Tanınmış aracı kartı konumunu kullanarak A2A Aracısı oluştur

Aşağıdaki senaryoda yaygın olarak bilinen temsilci kart konumu kullanılır. A2A aracı konağı kök URI'sini A2ACardResolver oluşturucuya geçirir ve çözümleyici aracı kartını https://your-a2a-agent-host/.well-known/agent-card.json'de arar.

İlk olarak, uzaktaki A2A aracı ana bilgisayarının URI'siyle bir A2ACardResolver oluşturun.

using System;
using A2A;
using Microsoft.Agents.AI;
using Microsoft.Agents.AI.A2A;

A2ACardResolver agentCardResolver = new(new Uri("https://your-a2a-agent-host"));

Uzaktaki A2A aracısı için AIAgent öğesinin bir örneğini GetAIAgentAsync yardımcı yöntemini kullanarak oluşturun.

AIAgent agent = await agentCardResolver.GetAIAgentAsync();

Doğrudan Yapılandırma / Özel Bulma mekanizmasını kullanarak A2A Aracısı oluşturma

Ayrıca, biliniyorsa doğrudan aracı URL'sine işaret etmek de mümkündür. Bu, istemcilerin doğrudan Aracı Kartı bilgileri ve aracı URL'si ile yapılandırıldığı sıkı bir şekilde bağlanmış sistemler, özel aracılar veya geliştirme amaçları için yararlı olabilir.

Bu durumda, aracının URL'sini doğrudan kullanarak bir A2AClient oluşturursunuz.

A2AClient a2aClient = new(new Uri("https://your-a2a-agent-host/echo"));

Ardından GetAIAgent yöntemini kullanarak AIAgent örneğini oluşturabilirsiniz.

AIAgent agent = a2aClient.GetAIAgent();

Ajanı Kullanma

Aracı standart bir AIAgent'dir ve tüm standart aracı işlemleri destekler.

Aracıları çalıştırma ve aracılarla etkileşim kurma hakkında daha fazla bilgi için bkz. Aracı kullanmaya başlama öğreticileri.

Başlangıç Yapmak

Projenize gerekli Python paketlerini ekleyin.

pip install agent-framework-a2a --pre

A2A Aracısı Oluşturma

Aşağıdaki senaryoda iyi bilinen ajan kartı konumu kullanılır. A2A aracısı ana bilgisayarının temel URL'sini A2ACardResolver oluşturucuya geçirir ve çözümleyici https://your-a2a-agent-host/.well-known/agent.json konumunda aracı kartını arar.

İlk olarak, uzak A2A aracı sunucusunun URL'si ile bir A2ACardResolver oluşturun.

import httpx
from a2a.client import A2ACardResolver

# Create httpx client for HTTP communication
async with httpx.AsyncClient(timeout=60.0) as http_client:
    resolver = A2ACardResolver(httpx_client=http_client, base_url="https://your-a2a-agent-host")

Aracı kartını alın ve uzak A2A aracısı için A2AAgent öğesinin bir örneğini oluşturun.

from agent_framework.a2a import A2AAgent

# Get agent card from the well-known location
agent_card = await resolver.get_agent_card(relative_card_path="/.well-known/agent.json")

# Create A2A agent instance
agent = A2AAgent(
    name=agent_card.name,
    description=agent_card.description,
    agent_card=agent_card,
    url="https://your-a2a-agent-host"
)

URL kullanarak A2A Aracısı oluşturma

Aracı URL'sine, biliniyorsa, doğrudan işaret etmek de mümkündür. Bu, istemcilerin doğrudan Aracı Kartı bilgileri ve aracı URL'si ile yapılandırıldığı sıkı bir şekilde bağlanmış sistemler, özel aracılar veya geliştirme amaçları için yararlı olabilir.

Bu durumda, doğrudan aracın URL'si ile bir A2AAgent oluşturursunuz.

from agent_framework.a2a import A2AAgent

# Create A2A agent with direct URL configuration
agent = A2AAgent(
    name="My A2A Agent",
    description="A directly configured A2A agent",
    url="https://your-a2a-agent-host/echo"
)

Ajanı Kullanma

A2A aracısı tüm standart aracı işlemlerini destekler.

Aracıları çalıştırma ve aracılarla etkileşim kurma hakkında daha fazla bilgi için bkz. Aracı kullanmaya başlama öğreticileri.

Sonraki Adımlar

Özel Temsilci