Files
microsoft--semantic-kernel/dotnet/samples/GettingStartedWithAgents/Plugins/WidgetFactory.cs
T
wehub-resource-sync b957a53def
CodeQL / Analyze (csharp) (push) Has been cancelled
CodeQL / Analyze (python) (push) Has been cancelled
chore: import upstream snapshot with attribution
2026-07-13 13:21:23 +08:00

64 lines
1.6 KiB
C#

// Copyright (c) Microsoft. All rights reserved.
using System.ComponentModel;
using System.Text.Json.Serialization;
using Microsoft.SemanticKernel;
namespace Plugins;
/// <summary>
/// A plugin that creates widgets.
/// </summary>
public sealed class WidgetFactory
{
[KernelFunction]
[Description("Creates a new widget of the specified type and colors")]
public WidgetDetails CreateWidget(
[Description("The type of widget to be created")] WidgetType widgetType,
[Description("The colors of the widget to be created")] WidgetColor[] widgetColors)
{
return new()
{
SerialNumber = $"{widgetType}-{string.Join("-", widgetColors)}-{Guid.NewGuid()}",
Type = widgetType,
Colors = widgetColors,
};
}
}
/// <summary>
/// A <see cref="JsonConverter"/> is required to correctly convert enum values.
/// </summary>
[JsonConverter(typeof(JsonStringEnumConverter))]
public enum WidgetType
{
[Description("A widget that is useful.")]
Useful,
[Description("A widget that is decorative.")]
Decorative
}
/// <summary>
/// A <see cref="JsonConverter"/> is required to correctly convert enum values.
/// </summary>
[JsonConverter(typeof(JsonStringEnumConverter))]
public enum WidgetColor
{
[Description("Use when creating a red item.")]
Red,
[Description("Use when creating a green item.")]
Green,
[Description("Use when creating a blue item.")]
Blue
}
public sealed class WidgetDetails
{
public string SerialNumber { get; init; }
public WidgetType Type { get; init; }
public WidgetColor[] Colors { get; init; }
}