# AgentParameter

> 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/http-api/schemas/agentparameter/
> Summary: OpenAPI request or response schema for AgentParameter, including required fields, defaults, constraints, and linked nested types.

[← All HTTP schemas](/http-api/schemas/)

A single named placeholder an AgentDefinition's instructions can
reference as `{{name}}`.

**Shape:** `object`

| Property | Required | Type | Description | Rules |
|---|---|---|---|---|
| `name` | yes | `string` | Gets the parameter name, as referenced by `{{name}}` in the instructions text. | — |
| `kind` | yes | [`AgentParameterKind`](/http-api/schemas/agentparameterkind/) | Gets the parameter's data kind. | — |
| `required` | no | `boolean` | Gets whether a run must supply this parameter. A run missing a required parameter with no `DefaultValue` does not start. | — |
| `defaultValue` | no | `string` | Gets the value used when a run does not supply this parameter. Applies whether or not `Required` is set. | — |
| `description` | no | `string` | Gets a short description shown to the person authoring a run. | — |