Skip to content

Agent Definition

Custom object AgentDefinition__c. Editable core configuration used to execute an AI agent.

FieldAPI nameTypeDescription
Agent Execution IdentityExecutionIdentity__cLookupDecides who the agent’s runs act as. Set: the identity’s execution user, through its Named Credential. Blank: whoever starts the run. An identity in use cannot be deleted; deactivate it instead.
Allow Multiple Tool Calls Per TurnAllowMultipleToolCalls__cCheckboxWhether one model turn may request several tool calls. Core runs them one after another as a batch and returns all results to the model together.
Developer NameDeveloperName__cTextStable API identifier for this agent definition.
InstructionsInstructions__cLongTextAreaSystem instructions supplied to the model for every run.
Is ActiveIsActive__cCheckboxControls whether new runs can use this definition.
Max Model CallsMaxModelCalls__cNumberMaximum model invocations allowed for one run, or for each reply of a conversational agent.
Max Model Request CharactersMaxModelRequestCharacters__cNumberMaximum characters Core assembles into one model request, including instructions, inputs, context, and transcript.
Max RetriesMaxRetries__cNumberOptional maximum retry attempts for one retryable command executed by this agent.
Max Tool CallsMaxToolCalls__cNumberMaximum tool invocations allowed for one run, or for each reply of a conversational agent.
Max Total TokensMaxTotalTokens__cNumberMaximum model tokens (input plus output, as the provider reports them) for one run, or for each reply of a conversational agent.
ModelModel__cTextAPI name of the active Agent Model record this agent calls. The record supplies the model adapter, Named Credential, provider model identifier, and prices.
Model Timeout SecondsModelTimeoutSeconds__cNumberCallout timeout passed to the model provider for each model request.
Output SchemaOutputSchema__cLongTextAreaJSON Schema required for the final model output.
Tool Authorization Policy ClassToolAuthorizationPolicyClass__cTextOptional query-only class implementing IToolAuthorizationPolicy.
Transcript Turn LimitTranscriptTurnLimit__cNumberMaximum prior turns (tool exchanges, human responses, operator guidance) replayed to the model.
Wait for Reply (Hours)ReplyWindowHours__cNumberMakes the agent conversational. After each answer the run waits this many hours for the person’s next message, with the conversation so far in the transcript. Blank ends the run with its first answer.

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