agents-core/ai.koog.agents.core.agent/singleRunStrategy

singleRunStrategy

fun singleRunStrategy(runMode: ToolCalls = ToolCalls.SINGLE_RUN_SEQUENTIAL): AIAgentStrategy<String, String>(source)

Creates a single-run strategy for an AI agent. This strategy defines a simple execution flow where the agent processes input, calls tools, and sends results back to the agent. The flow consists of the following steps:

  1. Start the agent.

  2. Call the LLM with the input.

  3. Execute a tool based on the LLM's response.

  4. Send the tool result back to the LLM.

  5. Repeat until LLM indicates no further tool calls are needed or the agent finishes.

Return

An instance of AIAgentStrategy configured according to the specified single-run mode.

Parameters

runMode

The mode in which the single-run strategy should operate. Defaults to SingleRunMode.SINGLE. - SingleRunMode.SINGLE: Executes without allowing multiple simultaneous tool calls. - SingleRunMode.SEQUENTIAL: Executes simultaneous tool calls sequentially. - SingleRunMode.PARALLEL: Executes multiple tool calls in parallel.