Table "Agent Task"
Virtual table that provides information about tasks created for and executed by AI agents in the system. This table enables tracking, monitoring, and management of agent task execution and status. Exposed to cloud, but read-only for non-Microsoft apps.
Remarks
The Agent Task table is central to the AI agent framework in Business Central, providing comprehensive task management capabilities for automated agents. It tracks task creation, execution status, ownership, and various task attributes including external identifiers for integration with other systems like Outlook or Teams. This table enables monitoring of agent performance, task completion rates, and identifying tasks that require human attention or intervention. The table includes audit trails showing who created tasks and detailed logging information for troubleshooting and compliance purposes.
Properties
| Name | Value |
|---|---|
| Caption | Agent Task |
| DataPerCompany | False |
| ReplicateData | False |
| Scope | Cloud |
Fields
| Name | Type | Description |
|---|---|---|
| ID | BigInteger | The unique identifier for the agent task. |
| "Agent User Security ID" | Guid | The security identifier of the agent user assigned to execute this task. |
| "Created By" | Guid | The security identifier of the user who created this agent task. |
| Status | Enum System.Agents."Agent Task Status" | The current execution status of the agent task. |
| "Company Name" | Text[30] | The name of the company context in which this agent task operates. |
| "Last Log Entry ID" | Integer | The identifier of the most recent log entry recorded for this task. |
| "Last Log Entry Timestamp" | DateTime | The timestamp when the most recent log entry was recorded for this task. |
| "Agent User Name" | Code[50] | The user name of the agent assigned to this task, retrieved from the Agent table. |
| "Agent Display Name" | Text[80] | The display name of the agent assigned to this task, retrieved from the Agent table. |
| "Created By User Name" | Code[50] | The user name of the person who created this agent task, retrieved from the User table. |
| "Created By Full Name" | Text[80] | The full name of the person who created this agent task, retrieved from the User table. |
| "External ID" | Text[2048] | External system identifier for integration with other platforms such as Outlook or Teams conversations. |
| Title | Text[150] | The descriptive title or name of the agent task. |
| "Created With Current Instructions" | Boolean | Indicates whether this task was created using the current instruction set for the agent. |
| "Needs Attention" | Boolean | Indicates whether this task requires human attention or intervention to proceed. |
| SystemId | Guid | |
| SystemCreatedAt | DateTime | |
| SystemCreatedBy | Guid | |
| SystemModifiedAt | DateTime | |
| SystemModifiedBy | Guid | |
| SystemRowVersion | BigInteger |