agents::ActorAgent Class Reference

Actor-based agent implementation. More...

#include <actor_agent.h>

Inheritance diagram for agents::ActorAgent:

Public Types
enum class	State {   READY ,   RUNNING ,   WAITING ,   COMPLETED ,   FAILED ,   STOPPED }
	Agent execution state. More...

Public Member Functions
	ActorAgent (std::shared_ptr< Context > context)
	Constructor with agent context.
virtual	~ActorAgent ()
	Destructor.
void	init () override
	Initialize the agent.
Task< JsonObject >	run (const std::string &task) override
	Run the agent with a task using coroutines.
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 for the agent.
std::string	getAgentPrompt () const
	Get the current agent prompt.
Task< std::string >	waitForFeedback (const std::string &message, const JsonObject &context) override
	Wait for feedback using coroutines.
void	runAsync (const std::string &task, std::function< void(const JsonObject &)> callback) override
	Run the agent asynchronously with callback.
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.

Detailed Description

Actor-based agent implementation.

This class implements a flexible agent that can operate autonomously, use tools, and achieve complex tasks.

Examples

simple_agent.cpp.

Member Enumeration Documentation

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

ActorAgent()

agents::ActorAgent::ActorAgent

(

std::shared_ptr< Context >

context

)

Constructor with agent context.

Parameters

context

The agent context

Member Function Documentation

getAgentPrompt()

std::string agents::ActorAgent::getAgentPrompt

(

)

const

Get the current agent prompt.

Returns

The current agent prompt

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

init()

void agents::ActorAgent::init ( )

overridevirtual

Initialize the agent.

Implements agents::Agent.

Examples

simple_agent.cpp.

provideFeedback()

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

overridevirtual

Provide human feedback.

Parameters

feedback

The feedback to provide

Reimplemented from agents::Agent.

run()

Task< JsonObject > agents::ActorAgent::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.

Examples

simple_agent.cpp.

runAsync()

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

overridevirtual

Run the agent asynchronously with callback.

Parameters

task	The task to run
callback	Callback function to call with result

Reimplemented from agents::Agent.

setAgentPrompt()

void agents::ActorAgent::setAgentPrompt

(

const std::string &

agent_prompt

)

Set the agent prompt for the agent.

Parameters

agent_prompt

The agent prompt to set

Examples

simple_agent.cpp.

setOptions()

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

inherited

Set execution options.

Parameters

options

The execution options

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.

stop()

void agents::ActorAgent::stop ( )

overridevirtual

Stop the agent.

Reimplemented from agents::Agent.

waitForFeedback()

Task< std::string > agents::ActorAgent::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 to wait for feedback

Returns

The feedback

Reimplemented from agents::Agent.