القائمة
Invoking a TypeScript Golem agent method from the CLI. Use when asked to call, invoke, or run a method on a deployed agent using golem agent invoke.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Adding a new TypeScript agent to a Golem component. Use when the user asks to create, add, or define a new agent type, implement an agent class, or add agent methods in a TypeScript Golem project.
Exposing a TypeScript Golem agent over HTTP. Use when the user asks to add HTTP endpoints, mount an agent to a URL path, or expose agent methods as a REST API.
Adding LLM and AI capabilities to a TypeScript Golem agent. Use when the user wants to add LLM chat, embeddings, or any AI provider integration to a TypeScript agent.
Adding secrets to TypeScript Golem agents. Use when the user asks to add secrets, store API keys, manage sensitive config values, or use Secret<T> in TypeScript agents.
Calling Golem agents from external TypeScript/Node.js applications using generated bridge SDKs. Use when the user wants to invoke agents from outside the Golem platform, from a Node.js server, script, or any TypeScript application.
Choosing between durable and ephemeral agents in a TypeScript Golem project. Use when the user asks about agent durability modes, making an agent stateless, or configuring agent persistence.
| name | golem-invoke-agent-ts |
| description | Invoking a TypeScript Golem agent method from the CLI. Use when asked to call, invoke, or run a method on a deployed agent using golem agent invoke. |
golem agent invokeBoth golem and golem-cli can be used — all commands below work with either binary.
golem agent invoke <AGENT_ID> <FUNCTION_NAME> [ARGUMENTS...]
This invokes a method on a deployed agent and waits for the result. The agent is automatically created on first invocation if it does not exist yet. Standard output, error, and log streams from the agent are streamed live to the terminal by default.
Text output renders return values using TypeScript syntax. Multiple return values are rendered as a TypeScript tuple, for example [1, "ok"]. Methods returning void or no value print void in text mode.
For machine-readable output, use --format json or --format yaml. A single return value includes result plus result_json; multiple return values include result plus results_json; methods returning void or no value omit result fields.
The agent ID identifies the agent type and its constructor parameters:
AgentTypeName(param1, param2, ...)
The agent ID can optionally be prefixed with environment or application paths:
| Format | Description |
|---|---|
AgentTypeName(params) | Standalone agent name |
env/AgentTypeName(params) | Environment-specific |
app/env/AgentTypeName(params) | Application and environment-specific |
account/app/env/AgentTypeName(params) | Account, application, and environment-specific |
For agents with no constructor parameters, use empty parentheses: AgentTypeName().
golem agent invoke 'MyAgent()' getStatus
golem agent invoke 'MyAgent("user-123")' processOrder '"order-456"' 42
golem agent invoke 'ChatRoom("general")' sendMessage '"Hello, world!"'
golem agent invoke 'staging/MyAgent("user-123")' getStatus
| Option | Description |
|---|---|
-t, --trigger | Only trigger the invocation without waiting for the result (fire-and-forget) |
-i, --idempotency-key <KEY> | Set a specific idempotency key; use "-" for auto-generated |
--no-stream | Disable live streaming of agent stdout/stderr/log |
--schedule-at <DATETIME> | Schedule the invocation at a specific time (requires --trigger; ISO 8601 format) |
Every invocation uses an idempotency key. If not provided, one is generated automatically. The same idempotency key guarantees that the invocation is executed at most once, even if the CLI call is retried.
golem agent invoke -i my-unique-key 'MyAgent()' doWork
If the agent's component has not been deployed yet and the CLI is run from an application directory, golem agent invoke will automatically build and deploy the component before invoking.
The agent ID parameters and method arguments use TypeScript syntax:
camelCaseundefined{ fieldOne: 1, fieldTwo: "hello" }"variant-name"{ tag: "variant-name", value: 42 }[1, "hello"]{ ok: value } / { error: value }golem agent invoke 'MyAgent("user-123")' updateProfile '{ displayName: "Alice", age: 30 }'