代理規則（AgentRule）表格/實體參考（Microsoft Dataverse）

事件與排程指令啟動的代理規則

Messages

下表列出代理規則（AgentRule）資料表的訊息。 訊息代表可以在表格上執行的作業。 它們也可能是事件。

名稱 是事件嗎？	Web API 作業	適用於 .NET 的 SDK
Assign 事件：真實	PATCH /agentrules（agentruleid） 更新ownerid屬性。	AssignRequest
Associate 事件：真實	關聯記錄	關聯記錄
Create 事件：真實	POST /agentrules 請參閱 建立	建立記錄
CreateMultiple 事件：真實	CreateMultiple	CreateMultipleRequest
Delete 事件：真實	DELETE /agentrules（agentruleid） 請參閱 刪除	刪除記錄
Disassociate 事件：真實	取消關聯記錄	取消關聯記錄
GrantAccess 事件：真實	GrantAccess	GrantAccessRequest
IsValidStateTransition 事件：False	IsValidStateTransition	IsValidStateTransitionRequest
ModifyAccess 事件：真實	ModifyAccess	ModifyAccessRequest
Restore 事件：真實	Restore	瞭解如何搭配 SDK for .NET 使用訊息
Retrieve 事件：真實	GET /agentrules（agentruleid） 請參閱 擷取	擷取記錄
RetrieveMultiple 事件：真實	GET /agentrules 請參閱 查詢資料	查詢數據
RetrievePrincipalAccess 事件：真實	RetrievePrincipalAccess	RetrievePrincipalAccessRequest
RetrieveSharedPrincipalsAndAccess 事件：真實	RetrieveSharedPrincipalsAndAccess	RetrieveSharedPrincipalsAndAccessRequest
RevokeAccess 事件：真實	RevokeAccess	RevokeAccessRequest
SetState 事件：真實	PATCH /agentrules（agentruleid） 更新statecode 和 statuscode 屬性。	SetStateRequest
Update 事件：真實	PATCH /agentrules（agentruleid） 查看 更新	更新記錄
UpdateMultiple 事件：真實	UpdateMultiple	UpdateMultipleRequest
Upsert 事件：False	PATCH /agentrules（agentruleid） 請參閱更新 插入表格列	UpsertRequest
UpsertMultiple 事件：False	UpsertMultiple	UpsertMultipleRequest

屬性

下表列出代理人規則（AgentRule）表格中選定的屬性。

房產	價值
DisplayName	代理人規則
顯示集合名稱	代理人規則
結構描述名稱	AgentRule
集合架構名稱	AgentRules
實體集名稱	agentrules
邏輯名稱	agentrule
邏輯集合名稱	agentrules
PrimaryId屬性	agentruleid
PrimaryName屬性	displayname
TableType	Standard
擁有權類型	UserOwned

可寫入的資料行/屬性

這些資料行/屬性會針對 IsValidForCreate 或 IsValidForUpdate 傳回 true （通常兩者）。 依 SchemaName 列出。

• 代理規則ID
• AgentUserID
• Description
• DisplayName
• EventType
• 匯入序列號
• 邏輯
• MCPPrompt
• Name
• OverriddenCreatedOn
• OwnerId
• OwnerId類型
• 規則定義
• 狀態代碼
• 狀態代碼
• 時區規則版本編號
• UTCConversionTimeZoneCode

代理規則ID

房產	價值
Description	實體執行個體的唯一識別碼
DisplayName	代理規則識別碼
IsValidForForm	否
IsValidForRead	沒錯
LogicalName	agentruleid
必要層級	系統必要
類型	Uniqueidentifier

AgentUserID

房產	價值
Description	擁有此規則的 Entra 代理使用者的物件 ID（OID）
DisplayName	代理使用者識別碼
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	agentuserid
必要層級	None
類型	String
Format	文字
FormatName	文字
Ime模式	自動
是可本地化	否
最大長度	100

Description

房產	價值
Description	此代理人規則的作用說明
DisplayName	Description
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	description
必要層級	None
類型	備忘錄
Format	文字
FormatName	文字
Ime模式	自動
是可本地化	否
最大長度	4000

DisplayName

房產	價值
Description	代理規則的顯示名稱
DisplayName	顯示名稱
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	displayname
必要層級	系統必要
類型	String
Format	文字
FormatName	文字
Ime模式	自動
是可本地化	否
最大長度	200

事件類型

房產	價值
Description	此規則適用於事件類型（電子郵件、文件、訊息、排程）
DisplayName	事件類型
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	eventtype
必要層級	系統必要
類型	String
Format	文字
FormatName	文字
Ime模式	自動
是可本地化	否
最大長度	50

ImportSequenceNumber

房產	價值
Description	建立此記錄的匯入序號。
DisplayName	匯入序號
IsValidForForm	否
IsValidForRead	沒錯
LogicalName	importsequencenumber
必要層級	None
類型	Integer
最大值	2147483647
最小值	-2147483648

Logic

房產	價值
Description	條件的邏輯運算子：全（AND）或任意（OR）
DisplayName	邏輯
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	logic
必要層級	系統必要
類型	String
Format	文字
FormatName	文字
Ime模式	自動
是可本地化	否
最大長度	10

MCPPrompt

房產	價值
Description	引用包含此規則指令的 MCPPrompt
DisplayName	教學
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	mcppromptid
必要層級	系統必要
類型	Lookup
Targets	麥克普朗普特

Name

房產	價值
Description	代理人規則名稱
DisplayName	Name
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	name
必要層級	系統必要
類型	String
Format	文字
FormatName	文字
Ime模式	自動
是可本地化	否
最大長度	200

OverriddenCreatedOn

房產	價值
Description	移轉記錄的日期和時間。
DisplayName	記錄建立時間
IsValidForForm	否
IsValidForRead	沒錯
LogicalName	overriddencreatedon
必要層級	None
類型	DateTime
CanChangeDateTime行為	否
日期時間行為	使用者本機
Format	DateOnly
Ime模式	無效
來源類型遮罩	0

擁有者ID

房產	價值
Description	擁有者識別碼
DisplayName	Owner
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	ownerid
必要層級	系統必要
類型	Owner
Targets	系統使用者、團隊

OwnerId類型

房產	價值
Description	擁有者 ID 類型
DisplayName
IsValidForForm	否
IsValidForRead	沒錯
LogicalName	owneridtype
必要層級	系統必要
類型	EntityName

RuleDefinition

房產	價值
Description	JSON 包含過濾條件與規則
DisplayName	規則定義
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	ruledefinition
必要層級	系統必要
類型	備忘錄
Format	文字
FormatName	文字
Ime模式	自動
是可本地化	否
最大長度	20000

statecode

房產	價值
Description	代理人規則的狀態
DisplayName	現況
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	statecode
必要層級	系統必要
類型	State
預設形式值
GlobalChoiceName	agentrule_statecode

statecode 選擇/選項

價值	Details
0	標籤： 活躍 預設狀態：1 不變量名稱： Active
1	標籤： 非活動 預設狀態：2 不變量名稱： Inactive

statuscode

房產	價值
Description	代理人規則地位的原因
DisplayName	狀態原因
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	statuscode
必要層級	None
類型	Status
預設形式值
GlobalChoiceName	agentrule_statuscode

statuscode 選項/選項

價值	Details
1	標籤： 活躍 狀態：0 TransitionData：無
2	標籤： 非活動 狀態：1 TransitionData：無

時區規則版本編號

房產	價值
Description	僅供內部使用。
DisplayName	時區規則版本號碼
IsValidForForm	否
IsValidForRead	沒錯
LogicalName	timezoneruleversionnumber
必要層級	None
類型	Integer
最大值	2147483647
最小值	-1

UTCConversionTimeZoneCode

房產	價值
Description	建立記錄時使用的時區代碼。
DisplayName	UTC 轉換時區代碼
IsValidForForm	否
IsValidForRead	沒錯
LogicalName	utcconversiontimezonecode
必要層級	None
類型	Integer
最大值	2147483647
最小值	-1

唯讀資料行/屬性

這些資料行/屬性會針對 IsValidForCreate 和 IsValidForUpdate 傳回 false。 依 SchemaName 列出。

• 擁有者名稱
• OwnerIdYomi名稱
• 擁有業務單位
• 擁有團隊
• 擁有用戶
• 版本編號

擁有者名稱

房產	價值
Description	業主姓名
DisplayName
IsValidForForm	否
IsValidForRead	沒錯
LogicalName	owneridname
必要層級	系統必要
類型	String
Format	文字
FormatName	文字
Ime模式	自動
是可本地化	否
最大長度	100

OwnerIdYomi名稱

房產	價值
Description	Yomi 所有者的名字
DisplayName
IsValidForForm	否
IsValidForRead	沒錯
LogicalName	owneridyominame
必要層級	系統必要
類型	String
Format	文字
FormatName	文字
Ime模式	自動
是可本地化	否
最大長度	100

擁有業務單位

房產	價值
Description	擁有記錄之業務單位的唯一識別碼
DisplayName	擁有業務單位
IsValidForForm	沒錯
IsValidForRead	沒錯
LogicalName	owningbusinessunit
必要層級	None
類型	Lookup
Targets	事業單位

擁有團隊

房產	價值
Description	擁有記錄之小組的唯一識別碼。
DisplayName	擁有團隊
IsValidForForm	否
IsValidForRead	沒錯
LogicalName	owningteam
必要層級	None
類型	Lookup
Targets	小組

擁有用戶

房產	價值
Description	擁有記錄之使用者的唯一識別碼。
DisplayName	擁有使用者
IsValidForForm	否
IsValidForRead	沒錯
LogicalName	owninguser
必要層級	None
類型	Lookup
Targets	systemuser

版本號

房產	價值
Description	版本號碼
DisplayName	版本號碼
IsValidForForm	否
IsValidForRead	沒錯
LogicalName	versionnumber
必要層級	None
類型	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
ReferencingAttribute	mcppromptid
ReferencingEntityNavigationPropertyName	MCPPrompt
是階層式
CascadeConfiguration	封存：RemoveLink 指派： NoCascade 刪除： RemoveLink 合併： NoCascade 重新父項： NoCascade RollupView： NoCascade 共： NoCascade 取消分享： NoCascade

business_unit_agentrule

一To-Many 關係： 事業單位business_unit_agentrule

房產	價值
參考實體	businessunit
參考屬性	businessunitid
ReferencingAttribute	owningbusinessunit
ReferencingEntityNavigationPropertyName	owningbusinessunit
是階層式
CascadeConfiguration	封存：Restrict 指派： NoCascade 刪除： Restrict 合併： NoCascade 重新父項： NoCascade RollupView： NoCascade 共： NoCascade 取消分享： NoCascade

owner_agentrule

一To-Many 關係： 擁有者owner_agentrule

房產	價值
參考實體	owner
參考屬性	ownerid
ReferencingAttribute	ownerid
ReferencingEntityNavigationPropertyName	ownerid
是階層式
CascadeConfiguration	封存：NoCascade 指派： NoCascade 刪除： NoCascade 合併： NoCascade 重新父項： NoCascade RollupView： NoCascade 共： NoCascade 取消分享： NoCascade

team_agentrule

一-To-Many 關係： 團隊 team_agentrule

房產	價值
參考實體	team
參考屬性	teamid
ReferencingAttribute	owningteam
ReferencingEntityNavigationPropertyName	owningteam
是階層式
CascadeConfiguration	封存：NoCascade 指派： NoCascade 刪除： NoCascade 合併： NoCascade 重新父項： NoCascade RollupView： NoCascade 共： NoCascade 取消分享： NoCascade

user_agentrule

一To-Many 關係： 系統使用者user_agentrule

房產	價值
參考實體	systemuser
參考屬性	systemuserid
ReferencingAttribute	owninguser
ReferencingEntityNavigationPropertyName	owninguser
是階層式
CascadeConfiguration	封存：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

房產	價值
ReferencingEntity	asyncoperation
ReferencingAttribute	regardingobjectid
參考實體導航屬性名稱	agentrule_AsyncOperations
是可自訂的	True
關聯功能表配置	可用離線：True 態度： DoNotDisplay 群組： Details 標籤： MenuId：空值 次： QueryApi：空 檢視標識碼： 00000000-0000-0000-0000-000000000000

agentrule_BulkDeleteFailures

多重To-One 關係： bulkdeletefailure agentrule_BulkDeleteFailures

房產	價值
ReferencingEntity	bulkdeletefailure
ReferencingAttribute	regardingobjectid
參考實體導航屬性名稱	agentrule_BulkDeleteFailures
是可自訂的	True
關聯功能表配置	可用離線：True 態度： DoNotDisplay 群組： Details 標籤： MenuId：空值 次： QueryApi：空 檢視標識碼： 00000000-0000-0000-0000-000000000000

agentrule_DeletedItemReferences

多To-One 關係： deleteditemreference agentrule_DeletedItemReferences

房產	價值
ReferencingEntity	deleteditemreference
ReferencingAttribute	deletedobject
參考實體導航屬性名稱	agentrule_DeletedItemReferences
是可自訂的	True
關聯功能表配置	可用離線：True 態度： DoNotDisplay 群組： Details 標籤： MenuId：空值 次： QueryApi：空 檢視標識碼： 00000000-0000-0000-0000-000000000000

agentrule_MailboxTrackingFolders

多重To-One 關係： mailboxtrackingfolder agentrule_MailboxTrackingFolders

房產	價值
ReferencingEntity	mailboxtrackingfolder
ReferencingAttribute	regardingobjectid
參考實體導航屬性名稱	agentrule_MailboxTrackingFolders
是可自訂的	True
關聯功能表配置	可用離線：True 態度： DoNotDisplay 群組： Details 標籤： MenuId：空值 次： QueryApi：空 檢視標識碼： 00000000-0000-0000-0000-000000000000

agentrule_PrincipalObjectAttributeAccesses

多重To-One 關係： principalobjectattributeaccess agentrule_PrincipalObjectAttributeAccesses

房產	價值
ReferencingEntity	principalobjectattributeaccess
ReferencingAttribute	objectid
參考實體導航屬性名稱	agentrule_PrincipalObjectAttributeAccesses
是可自訂的	True
關聯功能表配置	可用離線：True 態度： DoNotDisplay 群組： Details 標籤： MenuId：空值 次： QueryApi：空 檢視標識碼： 00000000-0000-0000-0000-000000000000

agentrule_ProcessSession

多To-One 關係： processsession agentrule_ProcessSession

房產	價值
ReferencingEntity	processsession
ReferencingAttribute	regardingobjectid
參考實體導航屬性名稱	agentrule_ProcessSession
是可自訂的	True
關聯功能表配置	可用離線：True 態度： DoNotDisplay 群組： Details 標籤： MenuId：空值 次： QueryApi：空 檢視標識碼： 00000000-0000-0000-0000-000000000000

agentrule_SyncErrors

多To-One 關係： 同步錯誤agentrule_SyncErrors

房產	價值
ReferencingEntity	syncerror
ReferencingAttribute	regardingobjectid
參考實體導航屬性名稱	agentrule_SyncErrors
是可自訂的	True
關聯功能表配置	可用離線：True 態度： DoNotDisplay 群組： Details 標籤： MenuId：空值 次： QueryApi：空 檢視標識碼： 00000000-0000-0000-0000-000000000000

另請參閱

Dataverse 資料表/實體參考
Dataverse Web API 參考
agentrule