← API reference
CANONICAL TYPE REFERENCE

UpdateAIAgentInput

Input for updating an AI agent. Only provided fields are changed.

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 updating an AI agent. Only provided fields are changed."""
input UpdateAIAgentInput {
  """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.