Skip to main content
Configure AiKA’s agent behavior to control how it processes queries, uses tools, and generates responses.

​
Overview

AiKA’s agent can be configured through the Portal’s Plugins settings: Plugins → AiKA settings → aika → agent These settings control the agent’s reasoning behavior, tool usage limits, and response generation.

​
Configuration Options

​
Temperature

Path: aika > agent > temperature Controls randomness in the agent’s responses.
  • 0: Deterministic, focused responses (recommended for most use cases)
  • 0.5: Balanced creativity and consistency
  • 1: Maximum creativity and variation
Default: 0
Range: 0-1

​
Show Reasoning

Path: aika > agent > showReasoning Display the agent’s internal reasoning/thinking process to users.
  • true: Shows thinking traces from reasoning models (e.g. GPT-5, Gemini-2.5-pro)
  • false: Only shows final responses
Default: false
Non-reasoning models ignore this setting.

​
Reasoning Effort

Path: aika > agent > reasoningEffort Controls how much computational effort reasoning models invest in their thought process.
  • low: Faster responses with basic reasoning
  • medium: Balanced reasoning depth and speed
  • high: Deeper reasoning but slower responses
Default: low
Currently only applies to OpenAI reasoning models (gpt-5.1, gpt-5.2).

​
Priority Processing

Path: aika > agent > priorityProcessing Enable priority processing for OpenAI API requests to get significantly lower and more consistent latency.
  • true: Enables priority tier (premium pricing)
  • false: Standard processing tier
Default: false

​
Max Steps

Path: aika > agent > maxSteps Limit the maximum number of steps (tool calls + reasoning iterations) the agent can take before stopping and providing a response. Default: 10 Recommended values:
  • 5: Simple queries, tight cost control
  • 10: Balanced for most use cases (recommended for production)
  • 20: Complex research and multi-step reasoning
  • undefined: No limit (not recommended for production)

​
Why Use maxSteps?

Without a step limit, the agent could:
  • Make excessive tool calls, increasing API costs
  • Take too long to respond to complex queries
  • Get stuck in reasoning loops
With maxSteps, the agent will:
  • Stop after reaching the limit
  • Ensure predictable response times and costs

​
Custom Instructions

Add custom instructions to guide the agent’s reasoning and response formatting.

​
Reasoning Instructions

Path: aika > agent > reasoningInstructions Guide how the agent thinks and makes decisions. Example:
These instructions are injected into the agent’s system prompt after the knowledge integration section.

​
Answer Instructions

Path: aika > agent > answerInstructions Guide how the agent formats and delivers responses. Example:
These instructions are injected into the response standards section of the system prompt.