← API reference
CANONICAL TYPE REFERENCE

UpsertAIAgentInput

Input for creating or updating an AI agent

Optional ID for updates

nameString!

Display name

Optional description

roleString!

Short role title

goalString!

What this agent is trying to achieve

backstoryString!

Rich context about expertise and perspective

Which AI adapter to use

modelString

Model override

Temperature override

Max response tokens override

Additional system prompt template

Expected output format

Max tool-calling iterations

Tools this agent can use

Allowlist of GraphQL operations

Timeout for a single invocation

View exact SDL
"""Input for creating or updating an AI agent"""
input UpsertAIAgentInput {
  """Optional ID for updates"""
  id: AIAgentID
  """Display name"""
  name: String!
  """Optional description"""
  description: String
  """Short role title"""
  role: String!
  """What this agent is trying to achieve"""
  goal: String!
  """Rich context about expertise and perspective"""
  backstory: String!
  """Which AI adapter to use"""
  adapterId: AIAdapterID!
  """Model override"""
  model: String
  """Temperature override"""
  temperature: Float
  """Max response tokens override"""
  maxTokens: Int
  """Additional system prompt template"""
  systemPromptTemplate: String
  """Expected output format"""
  responseFormat: AgentResponseFormat
  """Max tool-calling iterations"""
  maxIterations: Int
  """Tools this agent can use"""
  tools: [AgentToolRefInput!]
  """Allowlist of GraphQL operations"""
  allowedGraphQLOperations: [String!]
  """Timeout for a single invocation"""
  maxExecutionTimeSeconds: Int
}

One stable address across all schema views. Follow a field’s type to explore connections between domains.