An agent that operates autonomously to complete a task. More...

#include <autonomous_agent.h>

Inheritance diagram for agents::AutonomousAgent:

Classes
struct	Step
	Step in the agent's execution. More...

Public Types
enum class	PlanningStrategy { ZERO_SHOT , TREE_OF_THOUGHT , PLAN_AND_EXECUTE , REFLEXION , REACT }
	Planning strategy for the agent. More...
enum class	State { READY , RUNNING , WAITING , COMPLETED , FAILED , STOPPED }
	Agent execution state. More...

Public Member Functions
	AutonomousAgent (std::shared_ptr< Context > context)
	Constructor.
	~AutonomousAgent () override=default
	Destructor.
void	init () override
	Initialize the agent.
Task< JsonObject >	run (const std::string &task) override
	Run the agent with a task using coroutines.
void	runAsync (const std::string &task, std::function< void(const JsonObject &)> callback) override
	Run the agent with a callback.
void	stop () override
	Stop the agent.
void	provideFeedback (const std::string &feedback) override
	Provide human feedback.
void	setAgentPrompt (const std::string &agent_prompt)
	Set the agent prompt.
void	setPlanningStrategy (PlanningStrategy strategy)
	Set the planning strategy.
std::vector< Step >	getSteps () const
	Get the steps executed so far.
void	setStepCallback (std::function< void(const Step &)> callback)
	Set a callback for when a step is completed.
Task< std::string >	waitForFeedback (const std::string &message, const JsonObject &context) override
	Wait for feedback using coroutines.
std::shared_ptr< Context >	getContext () const
	Get the agent's context.
State	getState () const
	Get the agent's current state.
void	setOptions (const Options &options)
	Set execution options.
const Options &	getOptions () const
	Get execution options.
void	setStatusCallback (std::function< void(const std::string &)> callback)
	Set a callback for status updates.

Protected Member Functions
Task< JsonObject >	executeTask (const std::string &task)
	Execute the agent's task using coroutines.
Task< Step >	executeStep (std::string &step_description, JsonObject &context)
	Execute a step using coroutines.
void	recordStep (const Step &step)
	Record a completed step.
std::string	getToolDescriptions () const
	Get tool descriptions for prompts.
Task< JsonObject >	planZeroShot (const std::string &task)
	Plan using Zero Shot.
Task< JsonObject >	planTreeOfThought (const std::string &task)
	Plan using Tree of Thought.
Task< JsonObject >	planAndExecute (const std::string &task)
	Plan and execute.
Task< JsonObject >	planReflexion (const std::string &task)
	Plan using Reflexion.
Task< JsonObject >	planReact (const std::string &task)
	Plan using React.

Protected Attributes
std::string	agent_prompt_
	The agent prompt.
PlanningStrategy	planning_strategy_ = PlanningStrategy::REACT
	Planning strategy for the agent.
std::vector< Step >	steps_
	The steps executed so far.
std::function< void(const Step &)>	step_callback_
	Callback for when a step is completed.
std::function< void(const JsonObject &)>	task_callback_
	Callback for task's incremental updates.
std::atomic< bool >	should_stop_ {false}
	Execution state flag to indicate if the agent should stop.
std::promise< std::string >	feedback_promise_
	Promise for coroutine-based feedback.

Detailed Description

An agent that operates autonomously to complete a task.

Autonomous agents start with a task, plan steps to accomplish it, and use tools to execute those steps. They can be configured with various strategies and human-in-the-loop options.

Examples: autonomous_agent_example.cpp, and coroutine_example.cpp.

Member Enumeration Documentation

◆ PlanningStrategy

enum class agents::AutonomousAgent::PlanningStrategy

strong

Planning strategy for the agent.

Enumerator
ZERO_SHOT	Generate actions without explicit planning.
TREE_OF_THOUGHT	Generate multiple reasoning paths.
PLAN_AND_EXECUTE	Generate a plan then execute it.
REFLEXION	Reflect on past steps for improvement.
REACT	Reasoning and acting.

Examples: autonomous_agent_example.cpp.

◆ State

enum class agents::Agent::State

stronginherited

Agent execution state.

Enumerator
READY	Ready to start execution.
RUNNING	Currently executing.
WAITING	Waiting for human input.
COMPLETED	Execution completed successfully.
FAILED	Execution failed.
STOPPED	Execution stopped by user.

Constructor & Destructor Documentation

◆ AutonomousAgent()

agents::AutonomousAgent::AutonomousAgent ( std::shared_ptr< Context > context )

Constructor.

Parameters

context The agent context

Member Function Documentation

◆ executeStep()

Task< Step > agents::AutonomousAgent::executeStep	(	std::string &	step_description,
		JsonObject &	context )

protected

Execute a step using coroutines.

Parameters

step_description	The description of the step
context	The context

Returns: The result of the step

◆ executeTask()

Task< JsonObject > agents::AutonomousAgent::executeTask ( const std::string & task )

protected

Execute the agent's task using coroutines.

Parameters

task	The task to execute

Returns: The result of the task

◆ getContext()

std::shared_ptr< Context > agents::Agent::getContext ( ) const

inherited

Get the agent's context.

Returns: The agent context

◆ getOptions()

const Options & agents::Agent::getOptions ( ) const

inherited

Get execution options.

Returns: The execution options

◆ getState()

State agents::Agent::getState ( ) const

inherited

Get the agent's current state.

Returns: The agent state

◆ getSteps()

std::vector< Step > agents::AutonomousAgent::getSteps ( ) const

Get the steps executed so far.

Returns: The steps executed so far

◆ getToolDescriptions()

std::string agents::AutonomousAgent::getToolDescriptions ( ) const

protected

Get tool descriptions for prompts.

Returns: The tool descriptions

◆ init()

void agents::AutonomousAgent::init ( )

overridevirtual

Initialize the agent.

Implements agents::Agent.

Reimplemented in agents::VoiceAgent.

◆ planAndExecute()

Task< JsonObject > agents::AutonomousAgent::planAndExecute ( const std::string & task )

protected

Plan and execute.

Parameters

task	The task to plan

Returns: The plan

◆ planReact()

Task< JsonObject > agents::AutonomousAgent::planReact ( const std::string & task )

protected

Plan using React.

Parameters

task	The task to plan

Returns: The plan

◆ planReflexion()

Task< JsonObject > agents::AutonomousAgent::planReflexion ( const std::string & task )

protected

Plan using Reflexion.

Parameters

task	The task to plan

Returns: The plan

◆ planTreeOfThought()

Task< JsonObject > agents::AutonomousAgent::planTreeOfThought ( const std::string & task )

protected

Plan using Tree of Thought.

Parameters

task	The task to plan

Returns: The plan

◆ planZeroShot()

Task< JsonObject > agents::AutonomousAgent::planZeroShot ( const std::string & task )

protected

Plan using Zero Shot.

Parameters

task	The task to plan

Returns: The plan

◆ provideFeedback()

void agents::AutonomousAgent::provideFeedback ( const std::string & feedback )

overridevirtual

Provide human feedback.

Parameters

feedback The feedback

Reimplemented from agents::Agent.

◆ recordStep()

void agents::AutonomousAgent::recordStep ( const Step & step )

protected

Record a completed step.

Parameters

step	The step to record

◆ run()

Task< JsonObject > agents::AutonomousAgent::run ( const std::string & task )

overridevirtual

Run the agent with a task using coroutines.

Parameters

task	The task to run

Returns: The result of the task

Implements agents::Agent.

◆ runAsync()

void agents::AutonomousAgent::runAsync	(	const std::string &	task,
		std::function< void(const JsonObject &)>	callback )

overridevirtual

Run the agent with a callback.

Parameters

task	The task to run
callback	The callback for incremental updates

Reimplemented from agents::Agent.

◆ setAgentPrompt()

void agents::AutonomousAgent::setAgentPrompt ( const std::string & agent_prompt )

Set the agent prompt.

Parameters

agent_prompt The agent prompt

◆ setOptions()

void agents::Agent::setOptions ( const Options & options )

inherited

Set execution options.

Parameters

options The execution options

◆ setPlanningStrategy()

void agents::AutonomousAgent::setPlanningStrategy ( PlanningStrategy strategy )

Set the planning strategy.

Parameters

strategy The planning strategy

◆ setStatusCallback()

void agents::Agent::setStatusCallback ( std::function< void(const std::string &)> callback )

inherited

Set a callback for status updates.

Parameters

callback The callback to set

Examples: simple_agent.cpp.

◆ setStepCallback()

void agents::AutonomousAgent::setStepCallback ( std::function< void(const Step &)> callback )

Set a callback for when a step is completed.

Parameters

callback The callback

◆ stop()

void agents::AutonomousAgent::stop ( )

overridevirtual

Stop the agent.

Reimplemented from agents::Agent.

◆ waitForFeedback()

Task< std::string > agents::AutonomousAgent::waitForFeedback	(	const std::string &	message,
		const JsonObject &	context )

overridevirtual

Wait for feedback using coroutines.

Parameters

message	The message to wait for feedback
context	The context

Returns: The feedback

Reimplemented from agents::Agent.

Classes

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

◆ PlanningStrategy

◆ State

Constructor & Destructor Documentation

◆ AutonomousAgent()

Member Function Documentation

◆ executeStep()

◆ executeTask()

◆ getContext()

◆ getOptions()

◆ getState()

◆ getSteps()

◆ getToolDescriptions()

◆ init()

◆ planAndExecute()

◆ planReact()

◆ planReflexion()

◆ planTreeOfThought()

◆ planZeroShot()

◆ provideFeedback()

◆ recordStep()

◆ run()

◆ runAsync()

◆ setAgentPrompt()

◆ setOptions()

◆ setPlanningStrategy()

◆ setStatusCallback()

◆ setStepCallback()

◆ stop()

◆ waitForFeedback()