| title | agentSkill resource type |
|---|---|
| description | Represents a distinct capability or function that an agent can perform. |
| author | jasondou |
| ms.date | 11/06/2025 |
| ms.localizationpriority | medium |
| ms.subservice | entra-id |
| doc_type | resourcePageType |
Namespace: microsoft.graph
[!INCLUDE beta-disclaimer]
Represents a distinct capability or function that an agent can perform, as defined in the agentCardManifest.
| Property | Type | Description |
|---|---|---|
| description | String | A detailed description of the skill, intended to help clients or users understand its purpose and functionality. |
| displayName | String | A human-readable name for the skill. |
| examples | String collection | Example prompts or scenarios that this skill can handle. Provides a hint to the client on how to use the skill. |
| id | String | A unique identifier for the agent's skill. |
| inputModes | String collection | The set of supported input MIME types for this skill, overriding the agent's defaults. |
| outputModes | String collection | The set of supported output MIME types for this skill, overriding the agent's defaults. |
| security | securityRequirement collection | Security schemes necessary for the agent to leverage this skill. |
| tags | String collection | A set of keywords describing the skill's capabilities. |
None.
The following JSON representation shows the resource type.
{
"@odata.type": "#microsoft.graph.agentSkill",
"id": "String",
"displayName": "String",
"description": "String",
"tags": [
"String"
],
"examples": [
"String"
],
"inputModes": [
"String"
],
"outputModes": [
"String"
],
"security": [
{
"@odata.type": "microsoft.graph.securityRequirement"
}
]
}