agents

Reference for the agents tool of Agent host: list, get, send, approvals, digest and usage, with every action.

Updated 18 October 2026 · View as Markdown

The hosted agents of one workspace: see them, talk to them, read their digests and approvals queue and check usage. Each agent keeps its own memory and asks a person before anything risky. The door can watch and talk; it cannot decide.

Call it as geenius_agenthost(tool: "agents", action: "<action>", args: {...}) through Geenius OS.

Actions#

ActionWhat it does
listThe workspace's agents with their state (draft, running, paused or error), folder, tags, last run and last error. Filter by text, status, tag or archived.
getOne agent: its state, versions, connectors (never a secret), the newest definition and its last digest.
sendSends one message to a deployed agent and returns its answer. A risky action the agent wants to take does not happen: the answer is a pending approval id and a person decides in the app.
approvalsThe requests waiting for a person of the workspace: what, which agent, since when. You cannot decide them here.
digestThe last result of a scheduled agent: its digest text and when, or null.
usageWhat the plan holds and what is used: agents, this month's AI credits, tool calls a day. With an agent id, that agent's usage per day.