Skip to content

Agent Tool

Custom object AgentTool__c. Defines a tool exposed by an agent and the contract used to invoke it.

FieldAPI nameTypeDescription
Agent DefinitionAgentDefinition__cMasterDetailAgent definition that owns this tool configuration.
Allowed Sensitive Data CategoriesAllowedSensitiveDataCategories__cMultiselectPicklistSensitive-data categories Core may restore in memory immediately before this tool executes. Values: Email, Phone, Payment Card, US SSN, IBAN, Salesforce Classified.
Approval ModeApprovalMode__cPicklistWhether a call of this tool waits for a person. Not Required runs every call, and the agent’s authorization policy is not asked. Always Required waits for the Approver Type on every call; the policy is not asked. Decided by Policy asks the agent’s authorization policy about each call: it runs the call, denies it, or holds it for an approver the policy names. Blank means Not Required. Values: Not Required, Always Required, Decided by Policy.
Approval Timeout (Minutes)ApprovalTimeoutMinutes__cNumberMinutes an approval waits for a decision, from 1 to 10080 (7 days). Blank uses 1440 (24 hours). With Decided by Policy, a timeout the policy gives for a call replaces this one. Must be blank when Approval Mode is Not Required.
Approver QueueApproverQueue__cTextAPI name of the queue that owns this tool’s approvals when Approval Mode is Always Required and Approver Type is Queue. With Anchor Record Owner, the fallback queue used when the owner cannot decide or the run has no anchor. The queue must support Agent Approval records.
Approver TypeApproverType__cPicklistWho decides this tool’s approvals when Approval Mode is Always Required. Required then, and blank otherwise: with Decided by Policy, the policy names the approver for each call it holds. Values: User, Queue, Anchor Record Owner, Requester’s Manager, Approval Process.
Approver UserApproverUser__cLookupApprover when Approver Type is User. The user must be active and hold Agent Kernel Human Decision.
DescriptionDescription__cLongTextAreaModel-facing explanation of when and how to use this tool.
Developer NameDeveloperName__cTextStable API identifier for this tool within its agent.
Implementation ConfigurationImplementationConfiguration__cLongTextAreaOptional administrator-controlled JSON configuration passed only to the tool implementation.
Implementation TypeImplementationType__cPicklistWhose logic this tool runs: Standard for Pluto Core’s own tools, Flow for an admin-built Flow, Apex for a custom ITool class. Core copies it from the tool type on every save, so it is reportable and never disagrees with the tool type. Values: Standard, Flow, Apex.
Input SchemaInputSchema__cLongTextAreaJSON Schema required for model-supplied tool input.
Is ActiveIsActive__cCheckboxControls whether this tool is available to new runs.
Sort OrderSortOrder__cNumberDeterministic display and model-request order for this tool.
Tool TypeToolType__cTextAPI name of the Agent Tool Type record this tool runs, such as UpdateRecord. The tool type supplies the Apex class and decides how Core retries and recovers the tool.
When Approval ExpiresApprovalExpiryAction__cPicklistWhat Core does when nobody decides in time. The tool never runs after an expired approval. Required when Approval Mode is Always Required or Decided by Policy, and blank when it is Not Required. Values: Deny and Continue, Pause for Operator.

Pluto is licensed under the GNU Affero General Public License, version 3 only.