CANONICAL TYPE REFERENCE
UpsertAIAgentInput
Input for creating or updating an AI agent
Optional ID for updates
nameString!Display name
descriptionStringOptional 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
modelStringModel override
temperatureFloatTemperature override
maxTokensIntMax response tokens override
systemPromptTemplateStringAdditional system prompt template
Expected output format
Max tool-calling iterations
Tools this agent can use
allowedGraphQLOperations[String!]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.