Azure AI Foundry Agents Attributes
Following lists the supported schema attributes for the classic Azure AI Foundry Agents.
Note
The attribute list cannot be extended.
|
Parent Attribute Name |
Child Attribute Name |
Description |
|---|---|---|
|
identity |
- |
Unique identifier for the agent. |
|
name |
- |
Display name assigned to the agent. |
|
datasetId |
- |
Internal ISC dataset identifier for the agent. |
|
description |
- |
Text describing the agent's purpose and behavior. |
|
attributes
|
model |
Identifier of the AI model the agent uses (for example, a GPT variant). |
|
resources |
Tools or resources assigned to and accessible by the agent. |
|
|
connectedAgents |
Other agents connected to this agent as sub-agents or collaborators. |
|
|
top_p |
Controls the diversity of the agent's responses by limiting token selection to the top cumulative probability mass. Lower values produce more focused outputs; higher values allow more variety. |
|
|
temperature |
Controls the randomness of the agent's responses. Lower values produce more focused and consistent answers; higher values produce more diverse and creative outputs. |
|
|
tool_resources |
External resources required by specific tools assigned to the agent (for example, a list of file IDs for the Code Interpreter tool). |
|
|
metadata |
Custom key-value metadata attached to the agent. Supports up to 16 key-value pairs. |
|
|
response_format |
Specifies the preferred format for the agent's responses (for example, text or json_object). |
|
|
created_at |
Date and time when the agent was created. |
|
|
creator |
Identity that originally created the parent Foundry account resource through Azure Resource Manager (ARM) provisioning. Stored in systemData.createdBy. This is not the same as the RBAC Owner. |
|
|
last_modified_by |
Identity that last modified the parent Foundry account resource through ARM provisioning. Stored in systemData.lastModifiedBy. This is not the same as the RBAC Owner. |
Following lists the supported schema attributes for the new Azure AI Foundry Agents.
|
Attribute |
Description |
|---|---|
|
agent_guid |
The globally unique identifier for the agent. |
|
blueprintClientId |
The client ID (appId) of the Blueprint Service Principal. Used as the join key to link an AgentIdentity to its shared Blueprint in ISC. |
|
blueprintId |
The object ID of the Blueprint Service Principal in Entra ID. |
|
blueprintPrincipalId |
The principal ID of the Blueprint SP. Used for Entra identity linkage and governance. |
|
blueprintType |
The type classification of the Blueprint (for example, |
|
deploymentNames |
List of deployment names associated with the agent. |
|
instanceIdentityClientId |
The client ID (appId) of the AgentIdentity Service Principal — the runtime identity for this specific agent instance. |
|
instanceIdentityPrincipalId |
The principal ID of the AgentIdentity SP. Used for Entra identity linkage and governance. |
|
operationalState |
The current operational state of the agent. Possible values: |
|
primaryDeploymentName |
The name of the primary deployment. Used for stop and start operations on the agent. |
|
projectName |
The name of the Azure AI Foundry project that hosts this agent. |
|
published |
Indicates whether the agent has been published. |
|
version |
The version of the agent. Each version is aggregated as a separate Machine Identity in ISC. |
|
versionId |
The unique identifier for this specific agent version. |
|
versionStatus |
The status of this agent version (for example, |