← All types
Ob Object

AIAgentState

A reusable AI agent persona definition for LLM-driven workflow tasks

Fields

id

AIAgentID!Non-null

Unique identifier

name

String!Non-null

Display name

Optional description

role

String!Non-null

Short role title

goal

String!Non-null

What this agent is trying to achieve

Rich context about expertise and perspective

Which AI adapter to use for LLM calls

model

StringNullable

Model override

Temperature override

maxTokens

IntNullable

Max response tokens override

Additional system prompt template

Expected output format

Possible values (3)
TEXT

Free-form text response

JSON

Structured JSON response

TASK_OUTCOME

Task outcome response with outcome and outcomeData

Max tool-calling iterations

tools

[AgentToolRef!]!Non-null

Tools this agent can use

Allowlist of GraphQL operations

Timeout for a single invocation

Creation timestamp (ISO8601)

Last update timestamp (ISO8601)

Referenced by (3)
Exact type SDL
"""A reusable AI agent persona definition for LLM-driven workflow tasks"""
type AIAgentState @iac_resource(name: "ai_agent") @iac_ops(create: "createAIAgent", read: "getAIAgent", update: "updateAIAgent", delete: "deleteAIAgent") {
  """Unique identifier"""
  id: AIAgentID! @iac_identity(assignedBy: SERVER) @iac_computed
  """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 for LLM calls"""
  adapterId: AIAdapterID! @iac_ref(resource: "ai_adapter")
  """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: [AgentToolRef!]!
  """Allowlist of GraphQL operations"""
  allowedGraphQLOperations: [String!]
  """Timeout for a single invocation"""
  maxExecutionTimeSeconds: Int
  """Creation timestamp (ISO8601)"""
  createdAt: String! @iac_computed
  """Last update timestamp (ISO8601)"""
  updatedAt: String! @iac_computed
}