Microsoft Foundry Agent

Resource ID

Resource type

Identity attribute

agentName

The agent name or lineage identifier (for example, teams-agent).

string

No

atomic_unit

The stable GUID shared across all versions of the same agent lineage.

string

No

agentLaunchId

The Azure Resource Manager (ARM) resource path for the Foundry project. The connector uses this value during provisioning to construct deployment operations.

string

No

blueprintClientId

The client ID portion of the agent blueprint managed identity. Empty for legacy agents.

string

No

blueprintId

The stable, human-readable blueprint identifier (for example, teams-agent-safe). Empty for legacy agents.

string

No

blueprintPrincipalId

The Microsoft Entra object ID of the agent blueprint service principal (managed identity). Empty for legacy agents.

string

No

blueprintType

The blueprint type (for example, ManagedIdentityBaseBlueprint). Empty for legacy agents.

string

No

createdAt

The ISO-8601 timestamp when the agent version was created.

string

No

createdBy

The identity that created the parent Foundry project resource through ARM provisioning, stored in systemData.createdBy. This is not the RBAC owner.

string

No

deploymentNames

The ARM deployment names that reference this agent version.

string

No

description

The description of the agent version.

string

No

id

The primary key for the agent. For classic Foundry agents, the value follows the ProjectName/versionId format.

string

No

instanceClientId

The client ID of the agent instance service principal. When present, this value matches the Microsoft Graph agent identity.

string

No

instancePrincipalId

The Microsoft Entra object ID of the agent instance service principal. Empty for legacy agents.

string

No

instructions

The system prompt or instructions for this agent version.

string

No

kind

The agent kind. Possible values include prompt, toolset, workflow, and container_app.

string

No

lastModifiedBy

The identity that last modified the parent Foundry project resource through ARM provisioning, stored in systemData.lastModifiedBy. This is not the RBAC owner.

string

No

model

The AI model assigned to the agent (for example, gpt-4o or gpt-4).

string

No

modifiedAt

The ISO-8601 timestamp when the agent version was last modified, sourced from metadata:modifiedAt.

string

No

name

The display name of the agent or assistant.

string

No

operationalDate

The ARM deployment state for published versions. Possible values are Running and Stopped.

string

No

primary_deploymentName

The ARM deployment name the connector uses for step or start operations.

string

No

projectName

The name of the Foundry project that contains the agent (for example, TestProject).

string

No

published

Indicates whether the agent version is published (true when at least one ARM deployment exists for the version).

boolean

No

response_format

The response format setting for the agent. Supported for classic Foundry agents only.

string

No

saasInstanceLocation

The source SaaS instance name (Azure AI Foundry).

string

No

status

The operational state of the agent. Possible values are Active, Running, and Inactive (Stopped). Empty when the agent is not yet deployed.

string

No

temperature

The temperature parameter for the agent. Supported for classic Foundry agents only.

int

No

tools

The simplified list of tools allowed for this agent version.

string

No

top_p

The top-p sampling parameter for the agent. Supported for classic Foundry agents only.

int

No

version

The version label for the agent (for example, latest or v1).

string

No

versionId

The version ID for the agent (for example, 1, 2, or a raw ID).

string

No