Agent to Agent communication

See the Agent to Agent communication page for a general overview of how agents can invoke each other in Golem.

Code-first approach

When defining an agent in code, this automatically defines a client interface for calling remote agents as well. This way an agent of an agent type can create other agents and invoke methods on them. The target agent can be of any agent type available for the caller agent in code.

The simplest way to achieve this is to keep all the agent types that need to call each other in the same component. Otherwise the agent definition need to be extracted to some shared place and imported to all components involved.

Creating a client

The first step of calling a remote agent is creating a client for it by specifying which agent type it is and identifying the agent by providing values for its constructor parameters. If the agent identified by the parameters has not been existing yet, it is going to be created and its constructor is executed remotely. If it has been already created, the client just points to it and no action is taken until an agent method is called using it.

@agent()
class WeatherAgent extends BaseAgent {
    constructor(location: string) {
        super();
        // ...
    }
 
    @description("Gets the current weather")
    async currentWeather(): Promise<string> {
        // ...
    }
}
 
@agent()
class ExampleAgent extends BaseAgent {
    constructor() {
        super();
    }
 
    async run() {
        const weatherInLondon = WeatherAgent.get("London")
        // ...
    }
}

Calling a remote agent method

Once we have a client for a remote agent, it is possible to call its methods just as if it would be a local instance.

const currentWeather = await weatherInLondon.currentWeather();

Triggering execution of an agent method

It is possible to trigger the remote execution of an agent method without awaiting it. This is useful for spawning background tasks, for example.

const remoteAgent = BackgroundTaskAgent.get(backgroundJobId);
remoteAgent.runTask.trigger("hello", 1234);

Scheduling an agent method

An advanced case of triggering the execution of an agent method is to schedule it to be executed at a later time.

const remoteAgent = BackgroundTaskAgent.get(backgroundJobId);
remoteAgent.runTask.schedule({ seconds: X, nanoseconds: Y }, "hello", 1234);