What problem does it solve?
Rust Golem agents are not reachable over HTTP by default, so developers must manually wire up route definitions, mount paths, and deployment configuration to expose agent methods as a REST API.
Core Features & Use Cases
- Code-First Route Definitions: Add a
mount parameter to #[agent_definition] and annotate trait methods with #[endpoint(...)] to map HTTP methods and paths directly in Rust code.
- Automatic Response Mapping: Return types like
Option<T>, Result<T, E>, and UnstructuredBinary<M> map to appropriate HTTP status codes and JSON or binary bodies.
- Phantom Agents: Enable
phantom_agent = true to spawn a new agent instance per HTTP request for fully parallel processing.
- Use Case: You have a TaskAgent written in Rust and want clients to call
GET /task-agents/{name}/tasks over HTTP; this Skill walks you through the mount path, endpoint annotations, and the httpApi section in golem.yaml.
Quick Start
Ask the AI to expose your Rust Golem agent's methods as HTTP endpoints by adding a mount path and endpoint annotations, then updating golem.yaml with an httpApi deployment.