agents

Reference for the agents tool: create, read and list agents; running is part of the AI features.

Updated 17 October 2026 · View as Markdown

An agent holds instructions, a provider and settings such as temperature. Use versions to give it a history.

Call it as geenius_promptverse(tool: "agents", action: "<action>", args: {...}) through Geenius OS, or as the agents tool of the Prompt Verse MCP server with action and args.

Actions#

ActionWhat it does
createA new agent.
getOne agent with its definition.
listNewest first, optionally filtered by provider.
runOne turn: your message and its answer. Remembers the last 20 turns. Switched off in the pre-beta.

Arguments we have checked#

agents · create#

A new agent.

  • title (required): Name.
  • provider (required): internal, anthropic, openai, google or vercel.
  • data: The definition, such as instructions and temperature.

agents · get#

One agent with its definition.

  • id (required): Agent id.

agents · list#

Newest first, optionally filtered by provider.

  • provider: Provider.

agents · run#

One turn: your message and its answer. Remembers the last 20 turns. Switched off in the pre-beta.

  • id (required): Agent id.
  • message (required): What you say.
  • model_id: Optional model id.