mirror of
https://github.com/microsoft/agent-framework.git
synced 2026-06-16 21:04:09 +08:00
dd1e615dad
* .NET: Add A2AAgentOptions and align A2AAgent constructors with ChatClientAgent pattern Adds a new A2AAgentOptions class (Id, Name, Description, Clone) and an options-based constructor on A2AAgent, mirroring ChatClientAgent/ChatClientAgentOptions. The existing parameter-based constructor is preserved for backward compatibility and now delegates to the options-based one. Extension methods are extended with options-based overloads: - A2AClientExtensions.AsAIAgent(IA2AClient, A2AAgentOptions, ...) - A2AAgentCardExtensions.AsAIAgent(AgentCard, A2AAgentOptions, ...) - A2ACardResolverExtensions.GetAIAgentAsync(A2ACardResolver, A2AAgentOptions, ...) For card-based creation, user-supplied options override values from the agent card; Name and Description fall back to card values when not set. Options are cloned when stored on the agent to prevent post-construction mutation, matching the ChatClientAgent pattern. Resolves #5870. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Address PR review comments - Add Throw.IfNull(client) in A2AClientExtensions.AsAIAgent - Add Throw.IfNull(card) in A2AAgentCardExtensions.AsAIAgent - Clarify httpClient docs in A2ACardResolverExtensions.GetAIAgentAsync: it applies to the created A2A client, not to card discovery - Rename test methods from GetAIAgent_* to AsAIAgent_* to match the API under test Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
64 lines
3.0 KiB
C#
64 lines
3.0 KiB
C#
// Copyright (c) Microsoft. All rights reserved.
|
|
|
|
using Microsoft.Agents.AI;
|
|
using Microsoft.Agents.AI.A2A;
|
|
using Microsoft.Extensions.Logging;
|
|
using Microsoft.Shared.Diagnostics;
|
|
|
|
namespace A2A;
|
|
|
|
/// <summary>
|
|
/// Provides extension methods for <see cref="IA2AClient"/>
|
|
/// to simplify the creation of A2A agents.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// These extensions bridge the gap between A2A SDK client objects
|
|
/// and the Microsoft Agent Framework.
|
|
/// <para>
|
|
/// They allow developers to easily create AI agents that can interact
|
|
/// with A2A agents by handling the conversion from A2A clients to
|
|
/// <see cref="A2AAgent"/> instances that implement the <see cref="AIAgent"/> interface.
|
|
/// </para>
|
|
/// </remarks>
|
|
public static class A2AClientExtensions
|
|
{
|
|
/// <summary>
|
|
/// Retrieves an instance of <see cref="AIAgent"/> for an existing A2A agent.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// This method can be used to access A2A agents that support the
|
|
/// <see href="https://github.com/a2aproject/A2A/blob/main/docs/topics/agent-discovery.md#3-direct-configuration--private-discovery">Direct Configuration / Private Discovery</see>
|
|
/// discovery mechanism.
|
|
/// </remarks>
|
|
/// <param name="client">The <see cref="IA2AClient" /> to use for the agent.</param>
|
|
/// <param name="id">The unique identifier for the agent.</param>
|
|
/// <param name="name">The name of the agent.</param>
|
|
/// <param name="description">The description of the agent.</param>
|
|
/// <param name="loggerFactory">Optional logger factory for enabling logging within the agent.</param>
|
|
/// <returns>An <see cref="AIAgent"/> instance backed by the A2A agent.</returns>
|
|
public static AIAgent AsAIAgent(this IA2AClient client, string? id = null, string? name = null, string? description = null, ILoggerFactory? loggerFactory = null) =>
|
|
new A2AAgent(client, id, name, description, loggerFactory);
|
|
|
|
/// <summary>
|
|
/// Retrieves an instance of <see cref="AIAgent"/> for an existing A2A agent.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// This method can be used to access A2A agents that support the
|
|
/// <see href="https://github.com/a2aproject/A2A/blob/main/docs/topics/agent-discovery.md#3-direct-configuration--private-discovery">Direct Configuration / Private Discovery</see>
|
|
/// discovery mechanism.
|
|
/// </remarks>
|
|
/// <param name="client">The <see cref="IA2AClient" /> to use for the agent.</param>
|
|
/// <param name="options">
|
|
/// Configuration options that control the agent's identity, including its identifier, name, and description.
|
|
/// </param>
|
|
/// <param name="loggerFactory">Optional logger factory for enabling logging within the agent.</param>
|
|
/// <returns>An <see cref="AIAgent"/> instance backed by the A2A agent.</returns>
|
|
public static AIAgent AsAIAgent(this IA2AClient client, A2AAgentOptions options, ILoggerFactory? loggerFactory = null)
|
|
{
|
|
_ = Throw.IfNull(client);
|
|
_ = Throw.IfNull(options);
|
|
|
|
return new A2AAgent(client, options, loggerFactory);
|
|
}
|
|
}
|