Agen dalam Sistem A2A

Microsoft Agent Framework mendukung penggunaan agen jarak jauh yang diekspos melalui protokol A2A di aplikasi Anda menggunakan abstraksi yang sama AIAgent dengan agen lain.

Memulai Langkah Awal

Tambahkan paket NuGet yang diperlukan ke proyek Anda.

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

Membuat Agen A2A menggunakan lokasi kartu agen terkenal

Skenario berikut menggunakan lokasi kartu agen terkenal. Ini meneruskan URI akar host agen A2A ke A2ACardResolver konstruktor, dan resolver akan mencari kartu agen di https://your-a2a-agent-host/.well-known/agent-card.json.

Pertama, buat A2ACardResolver dengan URI host agen A2A yang berada di jarak jauh.

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

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

Buat instans AIAgent untuk agen A2A jarak jauh menggunakan metode bantu GetAIAgentAsync .

AIAgent agent = await agentCardResolver.GetAIAgentAsync();

Membuat Agen A2A menggunakan mekanisme Konfigurasi Langsung/Penemuan Privat

Anda juga dapat mengarahkan langsung ke URL agen jika diketahui. Ini dapat berguna untuk sistem yang terintegrasi erat, agen pribadi, atau tujuan pengembangan, saat klien dikonfigurasi langsung dengan informasi Kartu Agen dan URL agen.

Dalam hal ini, Anda membuat A2AClient langsung menggunakan URL agen.

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

Dan kemudian Anda dapat membuat sebuah instans AIAgent menggunakan metode AsAIAgent.

AIAgent agent = a2aClient.AsAIAgent();

Menggunakan Agen

Agen ini adalah AIAgent standar dan mendukung semua operasi agen standar.

Untuk informasi selengkapnya tentang cara menjalankan dan berinteraksi dengan agen, lihat tutorial Memulai Agen.

Memulai Langkah Awal

Tambahkan paket Python yang diperlukan ke proyek Anda.

pip install agent-framework-a2a --pre

Membuat Agen A2A

Skenario berikut menggunakan lokasi kartu agen terkenal. Ini meneruskan URL dasar host agen A2A ke A2ACardResolver konstruktor, dan resolver mencari kartu agen di https://your-a2a-agent-host/.well-known/agent.json.

Pertama, buat A2ACardResolver dengan URL host agen A2A jarak jauh.

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")

Dapatkan kartu agen dan buat instance A2AAgent untuk agen A2A jarak jauh.

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"
)

Membuat Agen A2A menggunakan URL

Anda juga dapat mengarahkan langsung ke URL agen jika diketahui. Ini dapat berguna untuk sistem yang terintegrasi erat, agen pribadi, atau tujuan pengembangan, saat klien dikonfigurasi langsung dengan informasi Kartu Agen dan URL agen.

Dalam hal ini, Anda membuat A2AAgent langsung menggunakan URL agen.

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"
)

Menggunakan Agen

Agen A2A mendukung semua operasi agen standar.

Untuk informasi selengkapnya tentang cara menjalankan dan berinteraksi dengan agen, lihat tutorial Memulai Agen.

Langkah selanjutnya

Agen Khusus