AIAgentState
A reusable AI agent persona definition for LLM-driven workflow tasks
Fields
Unique identifier
Display name
Optional description
Short role title
What this agent is trying to achieve
Rich context about expertise and perspective
Which AI adapter to use for LLM calls
Model override
Temperature override
Max response tokens override
Additional system prompt template
Expected output format
Possible values (3)
TEXTFree-form text response
JSONStructured JSON response
TASK_OUTCOMETask outcome response with outcome and outcomeData
Max tool-calling iterations
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
}