agentCommunicationConfiguration resource type

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents the communication configuration for an agent, including the endpoint binding (bot ID or callback URI) and the Teams message notification settings that agents use to receive messages.

Methods

Method	Return type	Description
Agent identity blueprint
Get	agentCommunicationConfiguration	Read the communication configuration of an agentIdentityBlueprint.
Update	agentCommunicationConfiguration	Replace the communication configuration of an agentIdentityBlueprint.
Agent identity
Get	agentCommunicationConfiguration	Read the communication configuration of an agentIdentity.
Update	agentCommunicationConfiguration	Replace the communication configuration of an agentIdentity.
reset	agentCommunicationConfiguration	Reset the communication configuration override for an agent identity, which restores effective configuration resolution to the agent blueprint level, and returns the blueprint's communication configuration as the new effective configuration.

Properties

Property	Type	Description
endpointConfiguration	agentEndpointConfiguration	The endpoint binding (bot ID or callback URI) that the agent uses to receive messages.
isOverridableAtAgentIdLevel	Boolean	Indicates whether individual agent instances created from this blueprint can override the endpointConfiguration. When true, each instance can override it; when false, every instance inherits it. Not nullable.
teamworkConfiguration	agentTeamworkConfiguration	The per-conversation-context message notification settings (group chat, channel, one-on-one chat, and meeting chat) that agents use.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.agentCommunicationConfiguration",
  "isOverridableAtAgentIdLevel": "Boolean",
  "endpointConfiguration": {"@odata.type": "microsoft.graph.agentEndpointConfiguration"},
  "teamworkConfiguration": {"@odata.type": "microsoft.graph.agentTeamworkConfiguration"}
}