agents-core/ai.koog.agents.core.environment/ContextualAgentEnvironment

ContextualAgentEnvironment

class ContextualAgentEnvironment(environment: AIAgentEnvironment, context: AIAgentContext) : AIAgentEnvironment(source)

Represents an AI agent environment that operates within the context of a specific agent framework.

This class acts as a decorator over an existing AIAgentEnvironment, augmenting operations with contextual processing using the provided AIAgentContext.

Parameters

environment

The underlying agent environment responsible for managing tool execution.

context

The context that augments the environment with additional behavioral and execution information.

Constructors

ContextualAgentEnvironment

constructor(environment: AIAgentEnvironment, context: AIAgentContext)

Constructs a new instance of ContextualAgentEnvironment with a decorated environment and a contextual context.

Functions

executeTool

open suspend override fun executeTool(toolCall: Message.Tool.Call): ReceivedToolResult

Executes a tool call and returns its result.

executeTools

open suspend fun executeTools(toolCalls: List<Message.Tool.Call>): List<ReceivedToolResult>

Executes a batch of tool calls within the AI agent environment and processes their results.

reportProblem

open suspend override fun reportProblem(exception: Throwable)

Reports a problem that occurred within the environment.