Closed
Description
Say I have such a tool input object class
public class TemporalData { [JsonPropertyName("dateTimeValue")] public DateTime DateTimeValue { get; set; } [JsonPropertyName("dateTimeOffsetValue")] public DateTimeOffset DateTimeOffsetValue { get; set; } [JsonPropertyName("timeSpanValue")] public TimeSpan TimeSpanValue { get; set; } } Its corresponding input schema (auto-generated by sdk 0.3.0, no hack here)is
{ "name": "test", "description": "Test tool that accepts a TemporalData object with DateTime, DateTimeOffset, and TimeSpan properties.", "inputSchema": { "type": "object", "properties": { "input": { "description": "A TemporalData object with temporal properties", "type": "object", "properties": { "dateTimeValue": { "type": "string" }, "dateTimeOffsetValue": { "type": "string" }, "timeSpanValue": { "$comment": "Represents a System.TimeSpan value.", "type": "string" } } } }, "required": [ "input" ] } } Three date time related types are there
DateTime- dateTimeValueDateTimeOffSet- dateTimeOffsetValueTimeSpan- timeSpanValue
As you can see, only TimeSpan type has been added a comment"$comment": "Represents a System.TimeSpan value.",automatically.
However, it's super important for AI agent to understand the field type especically when the type isn't supported in JSON natively like datetime, so sdk should provide a way to allow me to set a JsonSchemaGeneratorOptions to add a TypeMapping,
options.TypeMappings.Add( new JsonSchemaTypeMapping<DateTime>((_, schema) => { schema.Type = JsonSchemaType.String; schema.Format = "date-time"; schema.Comment = "Represents a System.DateTime"; return true; }) ); Then for DateTime type in inputSchema, it'll be like
"dateTimeValue": { "$comment": "Represents a System.DateTime", "type": "string", "format": "date-time" } Let me know if this makes sense