AiGenActionItem

Represents business actions suggested by generative AI. AI-generated action items are sent to either agents for automatic execution or human users for review, depending on org preference and if there are any errors in the process. This object is available in API version 64.0 and later.

Supported Calls

create( ), delete(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert ( )

Special Access Rules

Agentforce Pipeline Management must be enabled. Only the agent user can create AiGenActionItem records.

Fields

Field Details
ActionItemOwnerId
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
Required. The ID associated with the owner of the AI-generated action item. The owner can be an agent or human user, and can change during the review and execution process. By default, the owner is an agent or queue.
This field is a polymorphic relationship field.
Relationship Name
ActionItemOwner
Refers To
Group, User
ActionResult
Type
textarea
Properties
Create, Nillable, Update
Description
The result generated when the agent action is executed.
AgentType
Type
picklist
Properties
Create, Filter, Group, Restricted picklist, Sort, Update
Description
Required. The specific agent that processes the AI-generated action item.
AiGenActionItemInfoId
Type
reference
Properties
Filter, Group, Nillable, Sort, Update
Description
Required. The ID of the AI-generated action item information record associated with this action item. Available in API version 67.0 and later.
This field is a relationship field.
Relationship Name
AiGenActionItemInfo
Refers To
AiGenActionItemInfo
BotDefinitionId
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The bot record with a template name that matches the value in the Sales Management agent template.
This field is a relationship field.
Relationship Name
BotDefinition
Refers To
BotDefinition
BotVersionId
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The bot version from the bot record with an ID that matches the ID of the Sales Management agent bot record.
This field is a relationship field.
Relationship Name
BotVersion
Refers To
BotVersion
Description
Type
string
Properties
Create, Filter, Nillable, Sort, Update
Description
The explanation of why the action item has been suggested. The description provides additional context to guide human users and agents in their decision-making.
ExpirationDate
Type
dateTime
Properties
Create, Filter, Sort, Update
Description
Required. The date that the action item expires and is deleted. AI-generated action items are no longer visible to users after 14 days and removed from records after 30 days.
GeneratedResponseIdRef
Type
string
Properties
Filter, Group, Nillable, Sort
Description
The ID of generated result in the GenAIGeneration DMO. This field can be used by human users to provide feedback on the AI-generated action item.
OwnerId
Type
reference
Properties
Create, Defaulted on create, Filter, Group, Sort, Update
Description
The ID of the owner of this object.
This field is a polymorphic relationship field.
Relationship Name
Owner
Refers To
Group, User
ParentId
Type
reference
Properties
Filter, Group, Sort, Update
Description
Required. The ID of the record that the AI-generated action item is associated with. Available in API version 67.0 and later.
This field is a polymorphic relationship field.
Relationship Name
Parent
Refers To
Account, Opportunity
Status
Type
picklist
Properties
Create, Filter, Group, Restricted picklist, Sort, Update
Description
Required. The status of the AI-generated action item.
Subject
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
Required. The subject line that displays to users indicating what the action item is.
SuggestedNewValue
Type
textarea
Properties
Nillable, Update
Description
The new field value suggested by generative AI for the action item. Available in API version 67.0 and later.
Type
Type
picklist
Properties
Filter, Group, Nillable, Restricted picklist, Sort
Description
Required. The category that the action item falls under. This field can be used to search for specific action items, such as field updates or follow-up sales emails.
UnmodActionItemOutput
Type
textarea
Properties
Nillable
Description
Required. The unmodified output for the action item produced by AI, whether from a prompt template or other generation method.
Utterance
Type
textarea
Properties
Nillable, Update
Description
The user utterance or prompt that generated this action item. Available in API version 67.0 and later.