代理规则 （AgentRule） 表/实体引用 （Microsoft Dataverse）

事件和基于计划的指令激活的代理规则

Messages

下表列出了代理规则（AgentRule）表的消息。 消息表示可以在表上执行的作。 它们也可能是事件。

名称 是事件？	Web API 操作	用于 .NET 的 SDK
Assign 事件：True	PATCH /agentrules（agentruleid） 更新ownerid属性。	AssignRequest
Associate 事件：True	关联记录	关联记录
Create 事件：True	POST /agentrules 请参阅 创建	创建记录
CreateMultiple 事件：True	CreateMultiple	CreateMultipleRequest
Delete 事件：True	DELETE /agentrules（agentruleid） 请参阅 删除	删除记录
Disassociate 事件：True	取消关联记录	取消关联记录
GrantAccess 事件：True	GrantAccess	GrantAccessRequest
IsValidStateTransition 事件：False	IsValidStateTransition	IsValidStateTransitionRequest
ModifyAccess 事件：True	ModifyAccess	ModifyAccessRequest
Restore 事件：True	Restore	了解如何将消息与 SDK for .NET 配合使用
Retrieve 事件：True	GET /agentrules（agentruleid） 请参阅 检索	检索记录
RetrieveMultiple 事件：True	GET /agentrules 查看 查询数据	查询数据
RetrievePrincipalAccess 事件：True	RetrievePrincipalAccess	RetrievePrincipalAccessRequest
RetrieveSharedPrincipalsAndAccess 事件：True	RetrieveSharedPrincipalsAndAccess	RetrieveSharedPrincipalsAndAccessRequest
RevokeAccess 事件：True	RevokeAccess	RevokeAccessRequest
SetState 事件：True	PATCH /agentrules（agentruleid） 更新statecode 和 statuscode 属性。	SetStateRequest
Update 事件：True	PATCH /agentrules（agentruleid） 查看 更新	更新记录
UpdateMultiple 事件：True	UpdateMultiple	UpdateMultipleRequest
Upsert 事件：False	PATCH /agentrules（agentruleid） 请参阅更新 插入表行	UpsertRequest
UpsertMultiple 事件：False	UpsertMultiple	UpsertMultipleRequest

属性

下表列出了代理规则（AgentRule）表的选定属性。

财产	价值
显示名称	代理规则
显示集合名称	代理规则
架构名称	AgentRule
集合架构名称	AgentRules
实体集名称	agentrules
逻辑名称	agentrule
逻辑集合名称	agentrules
PrimaryId属性	agentruleid
PrimaryName属性	displayname
TableType	Standard
所有权类型	UserOwned

可写列/属性

这些列/属性为 IsValidForCreate 或 IsValidForUpdate （通常两者） 返回 true。 按 SchemaName 列出。

• AgentRuleId
• AgentUserId
• Description
• 显示名称
• EventType
• 导入序列号
• 逻辑
• MCPPromptId
• 名称
• 覆盖创建时间
• OwnerId
• 所有者 IdType
• 规则定义
• 状态代码
• 状态代码
• 时区规则版本编号
• UTCConversionTimeZoneCode

AgentRuleId

财产	价值
Description	实体实例的唯一标识符
显示名称	代理规则 ID
IsValidForForm （形式有效）	假
IsValidForRead	是
LogicalName	agentruleid
必需级别	系统必填
类型	Uniqueidentifier

AgentUserId

财产	价值
Description	拥有此规则的 Entra 代理用户的对象 ID （OID）
显示名称	代理用户 ID
IsValidForForm （形式有效）	是
IsValidForRead	是
LogicalName	agentuserid
必需级别	没有
类型	String
Format	文本
FormatName	文本
ImeMode	自动
是可本地化的	假
MaxLength （最大长度）	100

Description

财产	价值
Description	此代理规则的作用说明
显示名称	Description
IsValidForForm （形式有效）	是
IsValidForRead	是
LogicalName	description
必需级别	没有
类型	备忘录
Format	文本
FormatName	文本
ImeMode	自动
是可本地化的	假
MaxLength （最大长度）	4000

显示名称

财产	价值
Description	代理规则的显示名称
显示名称	显示名称
IsValidForForm （形式有效）	是
IsValidForRead	是
LogicalName	displayname
必需级别	系统必填
类型	String
Format	文本
FormatName	文本
ImeMode	自动
是可本地化的	假
MaxLength （最大长度）	200

事件类型

财产	价值
Description	此规则适用的事件类型（电子邮件、文档、邮件、计划）
显示名称	事件类型
IsValidForForm （形式有效）	是
IsValidForRead	是
LogicalName	eventtype
必需级别	系统必填
类型	String
Format	文本
FormatName	文本
ImeMode	自动
是可本地化的	假
MaxLength （最大长度）	50

ImportSequenceNumber

财产	价值
Description	创建此记录的导入的序列号。
显示名称	导入序列号
IsValidForForm （形式有效）	假
IsValidForRead	是
LogicalName	importsequencenumber
必需级别	没有
类型	Integer
最大值	2147483647
最小值	-2147483648

Logic

财产	价值
Description	条件的逻辑运算符：所有 （AND） 或任何 （OR）
显示名称	逻辑
IsValidForForm （形式有效）	是
IsValidForRead	是
LogicalName	logic
必需级别	系统必填
类型	String
Format	文本
FormatName	文本
ImeMode	自动
是可本地化的	假
MaxLength （最大长度）	10

MCPPromptId

财产	价值
Description	对包含此规则指令的 MCPPrompt 的引用
显示名称	教学
IsValidForForm （形式有效）	是
IsValidForRead	是
LogicalName	mcppromptid
必需级别	系统必填
类型	查找
Targets	mcpprompt

Name

财产	价值
Description	代理规则的名称
显示名称	名称
IsValidForForm （形式有效）	是
IsValidForRead	是
LogicalName	name
必需级别	系统必填
类型	String
Format	文本
FormatName	文本
ImeMode	自动
是可本地化的	假
MaxLength （最大长度）	200

OverriddenCreatedOn

财产	价值
Description	迁移记录的日期和时间。
显示名称	记录创建时间
IsValidForForm （形式有效）	假
IsValidForRead	是
LogicalName	overriddencreatedon
必需级别	没有
类型	DateTime
可以更改日期时间行为	假
日期时间行为	用户本地
Format	DateOnly
ImeMode	非活动
源类型掩码	0

所有者ID

财产	价值
Description	所有者 ID
显示名称	Owner
IsValidForForm （形式有效）	是
IsValidForRead	是
LogicalName	ownerid
必需级别	系统必填
类型	Owner
Targets	系统用户， 团队

所有者 IdType

财产	价值
Description	所有者 ID 类型
显示名称
IsValidForForm （形式有效）	假
IsValidForRead	是
LogicalName	owneridtype
必需级别	系统必填
类型	EntityName

RuleDefinition

财产	价值
Description	包含筛选器条件和规则的 JSON
显示名称	规则定义
IsValidForForm （形式有效）	是
IsValidForRead	是
LogicalName	ruledefinition
必需级别	系统必填
类型	备忘录
Format	文本
FormatName	文本
ImeMode	自动
是可本地化的	假
MaxLength （最大长度）	20000

statecode

财产	价值
Description	代理规则的状态
显示名称	Status
IsValidForForm （形式有效）	是
IsValidForRead	是
LogicalName	statecode
必需级别	系统必填
类型	State
默认表单值
全局选择名称	agentrule_statecode

statecode 选择/选项

价值	Details
0	标签： 活跃 默认状态：1 不变量名称： Active
1	标签： 不活跃 默认状态：2 不变量名称： Inactive

statuscode

财产	价值
Description	代理规则状态的原因
显示名称	状态描述
IsValidForForm （形式有效）	是
IsValidForRead	是
LogicalName	statuscode
必需级别	没有
类型	Status
默认表单值
全局选择名称	agentrule_statuscode

statuscode 选项/选项

价值	Details
1	标签： 活跃 状态：0 TransitionData：无
2	标签： 不活跃 状态：1 TransitionData：无

时区规则版本编号

财产	价值
Description	仅供内部使用。
显示名称	时区规则版本号
IsValidForForm （形式有效）	假
IsValidForRead	是
LogicalName	timezoneruleversionnumber
必需级别	没有
类型	Integer
最大值	2147483647
最小值	-1

UTCConversionTimeZoneCode

财产	价值
Description	创建记录时正在使用的时区代码。
显示名称	UTC 转换时区代码
IsValidForForm （形式有效）	假
IsValidForRead	是
LogicalName	utcconversiontimezonecode
必需级别	没有
类型	Integer
最大值	2147483647
最小值	-1

只读列/属性

这些列/属性为 IsValidForCreate 和 IsValidForUpdate 返回 false。 按 SchemaName 列出。

• 所有者名称
• OwnerIdYomiName
• 拥有业务单位
• 拥有团队
• 拥有用户
• 版本编号

所有者名称

财产	价值
Description	所有者姓名
显示名称
IsValidForForm （形式有效）	假
IsValidForRead	是
LogicalName	owneridname
必需级别	系统必填
类型	String
Format	文本
FormatName	文本
ImeMode	自动
是可本地化的	假
MaxLength （最大长度）	100

OwnerIdYomiName

财产	价值
Description	所有者的 Yomi 名称
显示名称
IsValidForForm （形式有效）	假
IsValidForRead	是
LogicalName	owneridyominame
必需级别	系统必填
类型	String
Format	文本
FormatName	文本
ImeMode	自动
是可本地化的	假
MaxLength （最大长度）	100

拥有业务单位

财产	价值
Description	拥有记录的业务部门的唯一标识符
显示名称	拥有业务单位
IsValidForForm （形式有效）	是
IsValidForRead	是
LogicalName	owningbusinessunit
必需级别	没有
类型	查找
Targets	businessunit

拥有团队

财产	价值
Description	拥有记录的团队的唯一标识符。
显示名称	拥有团队
IsValidForForm （形式有效）	假
IsValidForRead	是
LogicalName	owningteam
必需级别	没有
类型	查找
Targets	团队

拥有用户

财产	价值
Description	拥有记录的用户的唯一标识符。
显示名称	拥有用户
IsValidForForm （形式有效）	假
IsValidForRead	是
LogicalName	owninguser
必需级别	没有
类型	查找
Targets	systemuser

版本号

财产	价值
Description	版本号
显示名称	版本号
IsValidForForm （形式有效）	假
IsValidForRead	是
LogicalName	versionnumber
必需级别	没有
类型	BigInt
最大值	9223372036854775807
最小值	-9223372036854775808

多对一关系

这些关系是多对一的。 按 SchemaName 列出。

• AgentRule_MCPPrompt_MCPPrompt
• business_unit_agentrule
• owner_agentrule
• team_agentrule
• user_agentrule

AgentRule_MCPPrompt_MCPPrompt

一To-Many 关系： mcpprompt AgentRule_MCPPrompt_MCPPrompt

财产	价值
引用实体	mcpprompt
引用属性	mcppromptid
引用属性	mcppromptid
ReferencingEntityNavigationPropertyName	MCPPrompt
是层次结构
级联配置	存档：RemoveLink 分配： NoCascade 删除： RemoveLink 合并： NoCascade 重新父级： NoCascade RollupView： NoCascade 共享： NoCascade 取消分享： NoCascade

business_unit_agentrule

一To-Many 关系： 企业单位business_unit_agentrule

财产	价值
引用实体	businessunit
引用属性	businessunitid
引用属性	owningbusinessunit
ReferencingEntityNavigationPropertyName	owningbusinessunit
是层次结构
级联配置	存档：Restrict 分配： NoCascade 删除： Restrict 合并： NoCascade 重新父级： NoCascade RollupView： NoCascade 共享： NoCascade 取消分享： NoCascade

owner_agentrule

一To-Many 关系： 所有者owner_agentrule

财产	价值
引用实体	owner
引用属性	ownerid
引用属性	ownerid
ReferencingEntityNavigationPropertyName	ownerid
是层次结构
级联配置	存档：NoCascade 分配： NoCascade 删除： NoCascade 合并： NoCascade 重新父级： NoCascade RollupView： NoCascade 共享： NoCascade 取消分享： NoCascade

team_agentrule

一To-Many 关系： 团队team_agentrule

财产	价值
引用实体	team
引用属性	teamid
引用属性	owningteam
ReferencingEntityNavigationPropertyName	owningteam
是层次结构
级联配置	存档：NoCascade 分配： NoCascade 删除： NoCascade 合并： NoCascade 重新父级： NoCascade RollupView： NoCascade 共享： NoCascade 取消分享： NoCascade

user_agentrule

一To-Many 关系： systemuser user_agentrule

财产	价值
引用实体	systemuser
引用属性	systemuserid
引用属性	owninguser
ReferencingEntityNavigationPropertyName	owninguser
是层次结构
级联配置	存档：NoCascade 分配： NoCascade 删除： NoCascade 合并： NoCascade 重新父级： NoCascade RollupView： NoCascade 共享： NoCascade 取消分享： NoCascade

一对多关系

这些关系是一对多的。 按 SchemaName 列出。

• agentrule_AsyncOperations
• agentrule_BulkDeleteFailures
• agentrule_DeletedItemReferences
• agentrule_MailboxTrackingFolders
• agentrule_PrincipalObjectAttributeAccesses
• agentrule_ProcessSession
• agentrule_SyncErrors

agentrule_AsyncOperations

多To-One 关系： 异步agentrule_AsyncOperations

财产	价值
引用实体	asyncoperation
引用属性	regardingobjectid
引用实体导航属性名称	agentrule_AsyncOperations
是可定制的	True
关联菜单配置	可用离线：True 行为： DoNotDisplay 群： Details 标签： MenuId：空 次序： QueryApi：空 视图 ID： 00000000-0000-0000-0000-000000000000

agentrule_BulkDeleteFailures

多To-One 关系： bulkdeletefailure agentrule_BulkDeleteFailures

财产	价值
引用实体	bulkdeletefailure
引用属性	regardingobjectid
引用实体导航属性名称	agentrule_BulkDeleteFailures
是可定制的	True
关联菜单配置	可用离线：True 行为： DoNotDisplay 群： Details 标签： MenuId：空 次序： QueryApi：空 视图 ID： 00000000-0000-0000-0000-000000000000

agentrule_DeletedItemReferences

多To-One 关系： deleteditemreference agentrule_DeletedItemReferences

财产	价值
引用实体	deleteditemreference
引用属性	deletedobject
引用实体导航属性名称	agentrule_DeletedItemReferences
是可定制的	True
关联菜单配置	可用离线：True 行为： DoNotDisplay 群： Details 标签： MenuId：空 次序： QueryApi：空 视图 ID： 00000000-0000-0000-0000-000000000000

agentrule_MailboxTrackingFolders

多To-One 关系： mailboxtrackingfolder agentrule_MailboxTrackingFolders

财产	价值
引用实体	mailboxtrackingfolder
引用属性	regardingobjectid
引用实体导航属性名称	agentrule_MailboxTrackingFolders
是可定制的	True
关联菜单配置	可用离线：True 行为： DoNotDisplay 群： Details 标签： MenuId：空 次序： QueryApi：空 视图 ID： 00000000-0000-0000-0000-000000000000

agentrule_PrincipalObjectAttributeAccesses

多To-One 关系： principalobjectattributeaccess agentrule_PrincipalObjectAttributeAccesses

财产	价值
引用实体	principalobjectattributeaccess
引用属性	objectid
引用实体导航属性名称	agentrule_PrincipalObjectAttributeAccesses
是可定制的	True
关联菜单配置	可用离线：True 行为： DoNotDisplay 群： Details 标签： MenuId：空 次序： QueryApi：空 视图 ID： 00000000-0000-0000-0000-000000000000

agentrule_ProcessSession

多To-One 关系： 进程限制agentrule_ProcessSession

财产	价值
引用实体	processsession
引用属性	regardingobjectid
引用实体导航属性名称	agentrule_ProcessSession
是可定制的	True
关联菜单配置	可用离线：True 行为： DoNotDisplay 群： Details 标签： MenuId：空 次序： QueryApi：空 视图 ID： 00000000-0000-0000-0000-000000000000

agentrule_SyncErrors

多To-One 关系： 同步器agentrule_SyncErrors

财产	价值
引用实体	syncerror
引用属性	regardingobjectid
引用实体导航属性名称	agentrule_SyncErrors
是可定制的	True
关联菜单配置	可用离线：True 行为： DoNotDisplay 群： Details 标签： MenuId：空 次序： QueryApi：空 视图 ID： 00000000-0000-0000-0000-000000000000

另请参阅

Dataverse 表/实体引用
Dataverse Web API 参考
agentrule