# TraconGeneratedToolArguments
> Tracon documentation. Tracon is a .NET package family that adds a control
> plane on Microsoft Agent Framework, published as NuGet packages that run
> inside your own ASP.NET Core application.
>
> Page: https://tracon.dev/api/tracon.tracongeneratedtoolarguments/
> Summary: TraconGeneratedToolArguments: The helper methods called by tool wrappers produced by the source generator while converting JSON arguments to CLR types.
Namespace Tracon · Assembly Tracon.Abstractions.dll
The helper methods called by tool wrappers produced by the source
generator while converting JSON arguments to CLR types.
```csharp
public static class TraconGeneratedToolArguments
```
- Inheritance
- object ← TraconGeneratedToolArguments
- Inherited Members
- object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
## Remarks
This class is designed to be called only by code generated by the
`[TraconTool]` generator; calling it by hand is not a supported
scenario. The only reason it is public is that the generated code lives
in the consumer's own assembly and therefore needs to reach this type from outside this compilation.
No conversion **uses reflection**: everything works through
[JsonElement](https://learn.microsoft.com/dotnet/api/system.text.json.jsonelement)'s type-specific `Get*` methods or through
the converter delegate the caller supplies.
## Methods
### GetArray\(AIFunctionArguments, string, Func, bool, IReadOnlyList?\)
Reads an array argument; each element is converted with the same converter.
```csharp
public static IReadOnlyList GetArray(AIFunctionArguments arguments, string name, Func convert, bool required, IReadOnlyList? defaultValue)
```
#### Parameters
`arguments` AIFunctionArguments
The call's arguments.
`name` [string](https://learn.microsoft.com/dotnet/api/system.string)
The argument's JSON key.
`convert` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<[JsonElement](https://learn.microsoft.com/dotnet/api/system.text.json.jsonelement), T\>
The converter that converts each element.
`required` [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
Whether to throw if the argument is missing.
`defaultValue` [IReadOnlyList](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlylist\-1)?
The value to use if `required` is [false](https://learn.microsoft.com/dotnet/csharp/language-reference/builtin-types/bool)
and the argument is missing. An empty list is used if [null](https://learn.microsoft.com/dotnet/csharp/language-reference/keywords/null).
#### Returns
[IReadOnlyList](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlylist\-1)
The converted array.
#### Type Parameters
`T`
The array element type.
#### Exceptions
[TraconException](/api/tracon.traconexception/)
The argument is required but missing, or the given value is not a JSON array.
### GetOptional\(AIFunctionArguments, string, Func, T\)
Reads an optional argument; returns the given default if missing.
```csharp
public static T GetOptional(AIFunctionArguments arguments, string name, Func convert, T defaultValue)
```
#### Parameters
`arguments` AIFunctionArguments
The call's arguments.
`name` [string](https://learn.microsoft.com/dotnet/api/system.string)
The argument's JSON key.
`convert` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<[JsonElement](https://learn.microsoft.com/dotnet/api/system.text.json.jsonelement), T\>
The converter that turns a [JsonElement](https://learn.microsoft.com/dotnet/api/system.text.json.jsonelement) into `T`.
`defaultValue` T
The value to use if the argument is missing.
#### Returns
T
The converted value, or `defaultValue`.
#### Type Parameters
`T`
The target CLR type.
#### Exceptions
[TraconException](/api/tracon.traconexception/)
The argument was given but is an unexpected CLR type.
### GetRequired\(AIFunctionArguments, string, Func\)
Reads a required argument; throws if missing.
```csharp
public static T GetRequired(AIFunctionArguments arguments, string name, Func convert)
```
#### Parameters
`arguments` AIFunctionArguments
The call's arguments.
`name` [string](https://learn.microsoft.com/dotnet/api/system.string)
The argument's JSON key.
`convert` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<[JsonElement](https://learn.microsoft.com/dotnet/api/system.text.json.jsonelement), T\>
The converter that turns a [JsonElement](https://learn.microsoft.com/dotnet/api/system.text.json.jsonelement) into `T`.
#### Returns
T
The converted value.
#### Type Parameters
`T`
The target CLR type.
#### Exceptions
[TraconException](/api/tracon.traconexception/)
The argument is missing, or is an unexpected CLR type.