mirror of
https://github.com/microsoft/agent-framework.git
synced 2026-06-16 21:04:09 +08:00
e5f7b9c260
* support reflection for discovery of resources and scripts in class-based skills * fix format issues * refactor samples to use reflection * Validate resource member signatures during discovery Add discovery-time validation in AgentClassSkill.DiscoverResources() to fail fast when [AgentSkillResource] is applied to members with incompatible signatures: - Reject indexer properties (getter has parameters) - Reject methods with parameters other than IServiceProvider or CancellationToken Throws InvalidOperationException with actionable error messages instead of allowing silent runtime failures when ReadAsync invokes the AIFunction with no named arguments. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * prevent duplicates --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
75 lines
3.6 KiB
C#
75 lines
3.6 KiB
C#
// Copyright (c) Microsoft. All rights reserved.
|
|
|
|
using System;
|
|
using System.Diagnostics.CodeAnalysis;
|
|
using System.Reflection;
|
|
using System.Text.Json;
|
|
using System.Threading;
|
|
using System.Threading.Tasks;
|
|
using Microsoft.Extensions.AI;
|
|
using Microsoft.Shared.DiagnosticIds;
|
|
using Microsoft.Shared.Diagnostics;
|
|
|
|
namespace Microsoft.Agents.AI;
|
|
|
|
/// <summary>
|
|
/// A skill script backed by a delegate.
|
|
/// </summary>
|
|
[Experimental(DiagnosticIds.Experiments.AgentsAIExperiments)]
|
|
internal sealed class AgentInlineSkillScript : AgentSkillScript
|
|
{
|
|
private readonly AIFunction _function;
|
|
|
|
/// <summary>
|
|
/// Initializes a new instance of the <see cref="AgentInlineSkillScript"/> class from a delegate.
|
|
/// The delegate's parameters and return type are automatically marshaled via <see cref="AIFunctionFactory"/>.
|
|
/// </summary>
|
|
/// <param name="name">The script name.</param>
|
|
/// <param name="method">A method to execute when the script is invoked. Parameters are automatically deserialized from JSON.</param>
|
|
/// <param name="description">An optional description of the script.</param>
|
|
/// <param name="serializerOptions">
|
|
/// Optional <see cref="JsonSerializerOptions"/> used to marshal the delegate's parameters and return value.
|
|
/// When <see langword="null"/>, <see cref="AIJsonUtilities.DefaultOptions"/> is used.
|
|
/// </param>
|
|
public AgentInlineSkillScript(string name, Delegate method, string? description = null, JsonSerializerOptions? serializerOptions = null)
|
|
: base(Throw.IfNullOrWhitespace(name), description)
|
|
{
|
|
Throw.IfNull(method);
|
|
|
|
var options = new AIFunctionFactoryOptions { Name = this.Name, SerializerOptions = serializerOptions };
|
|
this._function = AIFunctionFactory.Create(method, options);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Initializes a new instance of the <see cref="AgentInlineSkillScript"/> class from a <see cref="MethodInfo"/>.
|
|
/// The method's parameters and return type are automatically marshaled via <see cref="AIFunctionFactory"/>.
|
|
/// </summary>
|
|
/// <param name="name">The script name.</param>
|
|
/// <param name="method">The method to execute when the script is invoked.</param>
|
|
/// <param name="target">The target instance for instance methods, or <see langword="null"/> for static methods.</param>
|
|
/// <param name="description">An optional description of the script.</param>
|
|
/// <param name="serializerOptions">
|
|
/// Optional <see cref="JsonSerializerOptions"/> used to marshal the method's parameters and return value.
|
|
/// When <see langword="null"/>, <see cref="AIJsonUtilities.DefaultOptions"/> is used.
|
|
/// </param>
|
|
public AgentInlineSkillScript(string name, MethodInfo method, object? target, string? description = null, JsonSerializerOptions? serializerOptions = null)
|
|
: base(Throw.IfNullOrWhitespace(name), description)
|
|
{
|
|
Throw.IfNull(method);
|
|
|
|
var options = new AIFunctionFactoryOptions { Name = this.Name, SerializerOptions = serializerOptions };
|
|
this._function = AIFunctionFactory.Create(method, target, options);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets the JSON schema describing the parameters accepted by this script, or <see langword="null"/> if not available.
|
|
/// </summary>
|
|
public override JsonElement? ParametersSchema => this._function.JsonSchema;
|
|
|
|
/// <inheritdoc/>
|
|
public override async Task<object?> RunAsync(AgentSkill skill, AIFunctionArguments arguments, CancellationToken cancellationToken = default)
|
|
{
|
|
return await this._function.InvokeAsync(arguments, cancellationToken).ConfigureAwait(false);
|
|
}
|
|
}
|