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.
Always Require ApprovalRequiresApproval__cCheckboxWhen checked, every call waits for a human decision before the tool runs. When unchecked, the tool runs unless the agent’s authorization policy denies it or asks for approval. Execution Safety never adds approval.
Approval Timeout (Hours)ApprovalTimeoutHours__cNumberHours an approval waits for a decision, from 1 to 168. Blank uses 24 hours. An authorization policy timeout overrides it.
Approver QueueApproverQueue__cTextAPI name of the queue that owns this tool’s approvals when 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. Required when Always Require Approval is checked; also used when the authorization policy asks for approval without naming an approver. 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. Values: Deny and Continue, Pause for Operator.

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