golem-schedule-agent-rust

Schedules future invocations of Rust Golem agent methods via the golem CLI.

1.5k|212|Updated Nov 24, 2023
One-click install
npx skills add https://github.com/golemcloud/golem --skill golem-schedule-agent-rust
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: golem-schedule-agent-rust
Source: https://github.com/golemcloud/golem/tree/main/golem-skills/skills/rust/golem-schedule-agent-rust
Command: npx skills add https://github.com/golemcloud/golem --skill golem-schedule-agent-rust

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Running a Golem agent method at a specific future time requires knowing the exact CLI flags, datetime format, and fire-and-forget semantics. This Skill provides the precise commands and rules for scheduling delayed agent invocations without trial and error.

Core Features & Use Cases

  • Scheduled Invocation: Uses golem agent invoke --trigger --schedule-at <DATETIME> to enqueue a method call for a future time in ISO 8601 / RFC 3339 format.
  • Idempotency Support: Accepts an idempotency key via -i so scheduled invocations are not executed more than once even if the command is retried.
  • Rust Value Syntax: Passes agent IDs and arguments using Rust syntax such as records, enums, options, and tuples.
  • Use Case: Schedule a ReportAgent to run generate_daily at 2026-03-15T10:30:00Z with a fixed idempotency key so the report is generated exactly once at the planned time.

Quick Start

Ask the AI to schedule a Golem agent method invocation at a specific future time using golem agent invoke with the --trigger and --schedule-at flags.

Frequently Asked Questions about golem-schedule-agent-rust

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I schedule a Golem agent invocation for a future time?

Run golem agent invoke --trigger --schedule-at <DATETIME> <AGENT_ID> <FUNCTION_NAME> with optional arguments. The --trigger flag is required because scheduled invocations are fire-and-forget, and the CLI returns immediately after the invocation is enqueued.

What datetime format does golem agent invoke --schedule-at accept?

The --schedule-at value must be in ISO 8601 / RFC 3339 format with a timezone, such as 2026-03-15T10:30:00Z for UTC or 2026-03-15T10:30:00+02:00 with an offset. Values without a timezone are not valid.

Can I prevent a scheduled Golem invocation from running twice?

Yes, pass an idempotency key with -i or --idempotency-key when scheduling. Providing the same key ensures the scheduled invocation is not executed more than once, even if the CLI command is retried.

Does golem agent invoke work with both golem and golem-cli binaries?

Yes, all scheduling commands work identically with either the golem or golem-cli binary. If the agent's component is not yet deployed and the CLI runs from an application directory, it automatically builds and deploys before scheduling.

How do I pass Rust records or enums as arguments to a scheduled agent method?

Arguments use Rust syntax: records like MyRecord { field_one: 1 }, enums like MyEnum::VariantName(value), options as Some(value) or None, and tuples like (1, "hello"). Field names use snake_case.