From 1df8c24ce98e6bbb6550ea55b71409dc8312613a Mon Sep 17 00:00:00 2001 From: Austin Pickett Date: Thu, 11 Jun 2026 16:43:54 -0400 Subject: [PATCH] docs: finish Automation Blueprints terminology rebrand Replace leftover "Automation Templates" wording from the Cron Recipes rebrand, rename the copy-paste cookbook guide to Automation Recipes, and point the marketing gallery link at the blueprints catalog. Co-authored-by: Cursor --- cron/blueprint_catalog.py | 4 ++-- hermes-already-has-routines.md | 2 +- hermes_cli/web_server.py | 2 +- tests/cron/test_blueprint_catalog.py | 2 +- web/src/lib/api.ts | 2 +- .../{automation-templates.md => automation-recipes.md} | 10 ++++++---- .../docs/reference/automation-blueprints-catalog.mdx | 4 ++-- .../{automation-templates.md => automation-recipes.md} | 10 ++++++---- website/sidebars.ts | 2 +- 9 files changed, 21 insertions(+), 17 deletions(-) rename website/docs/guides/{automation-templates.md => automation-recipes.md} (97%) rename website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/{automation-templates.md => automation-recipes.md} (98%) diff --git a/cron/blueprint_catalog.py b/cron/blueprint_catalog.py index b6cfc54576b..066ab22e6b4 100644 --- a/cron/blueprint_catalog.py +++ b/cron/blueprint_catalog.py @@ -1,4 +1,4 @@ -"""Automation Blueprints — parameterized automation templates with typed slots. +"""Automation Blueprints — parameterized automation blueprints with typed slots. A *blueprint* is a one-place definition of an automation that every surface renders natively: @@ -81,7 +81,7 @@ class BlueprintSlot: @dataclass(frozen=True) class AutomationBlueprint: - """A parameterized automation template.""" + """A parameterized automation blueprint.""" key: str title: str diff --git a/hermes-already-has-routines.md b/hermes-already-has-routines.md index fd4c04d679b..e33ebfab5ad 100644 --- a/hermes-already-has-routines.md +++ b/hermes-already-has-routines.md @@ -149,7 +149,7 @@ hermes webhook subscribe pr-review \ --deliver github_comment ``` -Full automation templates gallery: [hermes-agent.nousresearch.com/docs/guides/automation-templates](https://hermes-agent.nousresearch.com/docs/guides/automation-templates) +Full automation blueprints gallery: [hermes-agent.nousresearch.com/docs/reference/automation-blueprints-catalog](https://hermes-agent.nousresearch.com/docs/reference/automation-blueprints-catalog) Documentation: [hermes-agent.nousresearch.com](https://hermes-agent.nousresearch.com) diff --git a/hermes_cli/web_server.py b/hermes_cli/web_server.py index 40a5fc02eec..7813fb0d050 100644 --- a/hermes_cli/web_server.py +++ b/hermes_cli/web_server.py @@ -6779,7 +6779,7 @@ async def delete_cron_job(job_id: str, profile: Optional[str] = None): # --------------------------------------------------------------------------- -# Automation Blueprints — parameterized automation templates. The dashboard renders the +# Automation Blueprints — parameterized automation blueprints. The dashboard renders the # slot schema as a form; submitting instantiates a real cron job via the same # create_job path. See cron/blueprint_catalog.py for the single source of truth. # --------------------------------------------------------------------------- diff --git a/tests/cron/test_blueprint_catalog.py b/tests/cron/test_blueprint_catalog.py index a5470c81f8c..5bedffd4f77 100644 --- a/tests/cron/test_blueprint_catalog.py +++ b/tests/cron/test_blueprint_catalog.py @@ -1,4 +1,4 @@ -"""Tests for Automation Blueprints — the parameterized automation template system. +"""Tests for Automation Blueprints — the parameterized automation blueprint system. Covers the core catalog/slot schema/renderers/fill (cron/blueprint_catalog.py), the shared /blueprint command handler (hermes_cli/blueprint_cmd.py), and diff --git a/web/src/lib/api.ts b/web/src/lib/api.ts index 2be64723b2b..f3b62fb0f87 100644 --- a/web/src/lib/api.ts +++ b/web/src/lib/api.ts @@ -497,7 +497,7 @@ export const api = { deleteCronJob: (id: string, profile = "default") => fetchJSON<{ ok: boolean }>(`/api/cron/jobs/${encodeURIComponent(id)}?profile=${encodeURIComponent(profile)}`, { method: "DELETE" }), - // Automation Blueprints — parameterized automation templates + // Automation Blueprints — parameterized automation blueprints getAutomationBlueprints: () => fetchJSON<{ blueprints: AutomationBlueprint[] }>("/api/cron/blueprints"), instantiateAutomationBlueprint: ( diff --git a/website/docs/guides/automation-templates.md b/website/docs/guides/automation-recipes.md similarity index 97% rename from website/docs/guides/automation-templates.md rename to website/docs/guides/automation-recipes.md index f564bf5cee9..b4c8f4487f1 100644 --- a/website/docs/guides/automation-templates.md +++ b/website/docs/guides/automation-recipes.md @@ -1,14 +1,16 @@ --- sidebar_position: 15 -title: "Automation Templates" +title: "Automation Recipes" description: "Ready-to-use automation recipes — scheduled tasks, GitHub event triggers, API webhooks, and multi-skill workflows" --- -# Automation Templates +# Automation Recipes -Copy-paste recipes for common automation patterns. Each template uses Hermes's built-in [cron scheduler](/user-guide/features/cron) for time-based triggers and [webhook platform](/user-guide/messaging/webhooks) for event-driven triggers. +Copy-paste recipes for common automation patterns. Each recipe uses Hermes's built-in [cron scheduler](/user-guide/features/cron) for time-based triggers and [webhook platform](/user-guide/messaging/webhooks) for event-driven triggers. -Every template works with **any model** — not locked to a single provider. +Every recipe works with **any model** — not locked to a single provider. + +For parameterized, ready-to-run automations with forms instead of cron syntax, see the [Automation Blueprints Catalog](/reference/automation-blueprints-catalog). :::tip Three Trigger Types | Trigger | How | Tool | diff --git a/website/docs/reference/automation-blueprints-catalog.mdx b/website/docs/reference/automation-blueprints-catalog.mdx index 51dc92c3226..820f5d87199 100644 --- a/website/docs/reference/automation-blueprints-catalog.mdx +++ b/website/docs/reference/automation-blueprints-catalog.mdx @@ -1,14 +1,14 @@ --- sidebar_position: 7 title: "Automation Blueprints Catalog" -description: "Ready-to-run automation templates — set one up from the dashboard, CLI, TUI, any messenger, or the desktop app." +description: "Ready-to-run automation blueprints — set one up from the dashboard, CLI, TUI, any messenger, or the desktop app." --- import AutomationBlueprintsCatalog from '@site/src/components/AutomationBlueprintsCatalog'; # Automation Blueprints -Automation Blueprints are ready-to-run automation templates. Pick one, fill in a couple +Automation Blueprints are ready-to-run automations. Pick one, fill in a couple of fields, and Hermes schedules it as a cron job — no cron syntax required. Every blueprint works from **every surface**: diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/automation-templates.md b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/automation-recipes.md similarity index 98% rename from website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/automation-templates.md rename to website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/automation-recipes.md index 2eecd548b1e..c1547a8a557 100644 --- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/automation-templates.md +++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/guides/automation-recipes.md @@ -1,14 +1,16 @@ --- sidebar_position: 15 -title: "自动化模板" +title: "自动化配方" description: "开箱即用的自动化配方——定时任务、GitHub 事件触发、API webhook 及多技能工作流" --- -# 自动化模板 +# 自动化配方 -常见自动化模式的复制粘贴配方。每个模板使用 Hermes 内置的 [cron 调度器](/user-guide/features/cron) 实现基于时间的触发，使用 [webhook 平台](/user-guide/messaging/webhooks) 实现事件驱动触发。 +常见自动化模式的复制粘贴配方。每个配方使用 Hermes 内置的 [cron 调度器](/user-guide/features/cron) 实现基于时间的触发，使用 [webhook 平台](/user-guide/messaging/webhooks) 实现事件驱动触发。 -所有模板适用于**任意模型**——不绑定单一提供商。 +所有配方适用于**任意模型**——不绑定单一提供商。 + +如需带表单的参数化即用自动化（无需手写 cron 语法），请参阅[自动化蓝图目录](/reference/automation-blueprints-catalog)。 :::tip 三种触发类型 | 触发方式 | 方式 | 工具 | diff --git a/website/sidebars.ts b/website/sidebars.ts index 3dac24ba59f..b68c3730a6c 100644 --- a/website/sidebars.ts +++ b/website/sidebars.ts @@ -684,7 +684,7 @@ const sidebars: SidebarsConfig = { 'guides/build-a-hermes-plugin', 'guides/automate-with-cron', 'guides/cron-script-only', - 'guides/automation-templates', + 'guides/automation-recipes', 'guides/cron-troubleshooting', 'guides/work-with-skills', 'guides/delegation-patterns',