agentscope.server.servicer module

Server of distributed agent

class AgentServerServicer(stop_event: Event, host: str = 'localhost', port: int | None = None, server_id: str | None = None, studio_url: str | None = None, capacity: int = 32, pool_type: str = 'local', redis_url: str = 'redis://localhost:6379', max_pool_size: int = 8192, max_expire_time: int = 7200, max_timeout_seconds: int = 5)[source]

Bases: RpcAgentServicer

A Servicer for RPC Agent Server (formerly RpcServerSideWrapper)

agent_exists(agent_id: str) bool[source]

Check whether the agent exists.

Parameters:

agent_id (str) – the agent id.

Returns:

whether the agent exists.

Return type:

bool

call_agent_func(request: CallFuncRequest, context: ServicerContext) GeneralResponse[source]

Call the specific servicer function.

create_agent(request: CreateAgentRequest, context: ServicerContext) GeneralResponse[source]

Create a new agent on the server.

delete_agent(request: StringMsg, context: ServicerContext) GeneralResponse[source]

Delete agents from the server.

Parameters:
  • request (StringMsg) – The value field is the agent_id of the

  • deleted. (agents to be)

delete_all_agents(request: Empty, context: ServicerContext) GeneralResponse[source]

clear all agent on the server

download_file(request: StringMsg, context: ServicerContext) Any[source]

Download file from local path.

get_agent(agent_id: str) Any[source]

Get the object by agent id.

Parameters:

agent_id (str) – the agent id.

Returns:

the object.

Return type:

Any

get_agent_list(request: Empty, context: ServicerContext) GeneralResponse[source]

Get id of all agents on the server as a list.

get_agent_memory(request: StringMsg, context: ServicerContext) StringMsg[source]

Get the memory of a specific agent.

get_server_info(request: Empty, context: ServicerContext) GeneralResponse[source]

Get the agent server resource usage information.

is_alive(request: Empty, context: ServicerContext) GeneralResponse[source]

Check whether the server is alive.

set_model_configs(request: StringMsg, context: ServicerContext) GeneralResponse[source]

Set the model configs of the agent server.

stop(request: Empty, context: ServicerContext) GeneralResponse[source]

Stop the server.

update_placeholder(request: UpdatePlaceholderRequest, context: ServicerContext) CallFuncResponse[source]

Update the value of a placeholder.