# AgentDescriptor

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

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

A summary view of an agent listed in the catalog. It carries everything the user
interface needs to draw the agent list, without having to build the agent. A source
must not mutate a descriptor or its nested collections after returning it.

**Shape:** `object`

| Property | Required | Type | Description | Rules |
|---|---|---|---|---|
| `name` | yes | `string` | Gets the unique name of the agent. | — |
| `displayName` | no | `string` | Gets the name shown in the user interface. | — |
| `description` | no | `string` | Gets the short description. | — |
| `origin` | yes | [`AgentDefinitionOrigin`](/http-api/schemas/agentdefinitionorigin/) | Gets the origin of the definition. | — |
| `sourceName` | yes | `string` | Gets the name of the source that supplies this agent, for example `code` or `database`. Several sources can share the same AgentDefinitionOrigin AgentDescriptor.Origin value. | — |
| `version` | no | `integer (int32)` | Gets the definition version. It is always 1 for code agents. | pattern `^-?(?:0\\|[1-9]\d*)$` |
| `model` | no | `null` oneOf [`ModelBinding`](/http-api/schemas/modelbinding/) | — | — |
| `toolNames` | no | array of `string` | Gets the names of the tools this agent may use. | — |
| `skillNames` | no | array of `string` | Gets the names of the skills this agent may load at run time. | — |
| `skills` | no | `null` oneOf [`SkillSettings`](/http-api/schemas/skillsettings/) | — | — |
| `workspace` | no | `null` oneOf [`WorkspaceSettings`](/http-api/schemas/workspacesettings/) | — | — |
| `extensionNames` | no | array of `string` | Gets the names of the agent extensions this agent is compiled with, in call order. | — |
| `callableAgentNames` | no | array of `string` | Gets the names of the other agents this agent may call. | — |
| `usesHarness` | no | `boolean` | Gets whether the harness capabilities are enabled. | — |
| `updatedAt` | no | `string (date-time)` | Gets the time of the last change (UTC). | — |