
# HeySummon Expert Skill You are a human-help expert for AI agents via HeySummon. ## Two kinds of inbound: help vs notify Consumers (AI agents) reach you through two distinct verbs, and they render differently on the dashboard and on your notification channel: - **`help()` — reply expected.** The agent is stuck, needs approval, or needs your judgment before it can continue. It is **blocking on you**. Treat these as the default and respond (or Approve/Deny) as soon as you can. Event type:
Ask a human expert for help via HeySummon. Use when you need approval, are stuck, or need human judgment. Sends the question and blocks until the expert replies.
Loop a human expert into your workflow via HeySummon. Use `help` when you need approval, are stuck, or need human judgment (blocking); use `notify` to send a status heads-up that needs no reply (fire-and-forget). Triggers on "hey summon <name>", "heysummon <name> <question>", or "notify <name> <message>".
# HeySummon Expert Skill You are a human-help expert for AI agents via HeySummon. ## Setup ### Step 1: Configure .env Check if `.env` exists in `{baseDir}`. If not, copy from `.env.example`: ```bash cp {baseDir}/.env.example {baseDir}/.env ``` Required variables: - `HEYSUMMON_BASE_URL` — Platform URL (cloud: `https://cloud.heysummon.ai`, self-hosted: user provides) - `HEYSUMMON_API_KEY` — Expert key (`hs_exp_...`) from the dashboard - `HEYSUMMON_NOTIFY_TARGET` — Chat ID for notifications
Loop a human expert into your workflow via HeySummon. Use `help` when you need approval, are stuck, or need human judgment (blocking); use `notify` to send a status heads-up that needs no reply (fire-and-forget). Triggers on "hey summon <name>", "heysummon <name> <question>", or "notify <name> <message>".
Loop a human expert into your workflow via HeySummon. Use `help` when you need approval, are stuck, or need human judgment (blocking); use `notify` to send a status heads-up that needs no reply (fire-and-forget). Triggers on "hey summon <name>", "heysummon <name> <question>", or "notify <name> <message>".
# HeySummon -- Human in the Loop HeySummon has two distinct verbs. Pick the one that matches your intent: - **Use `help()` when:** the agent is stuck, needs approval, or needs human judgment before continuing. The script **blocks** until the expert replies. - **Use `notify()` when:** the human doesn't need to act — shipped-work notices, status heads-ups, low-urgency signals. The call returns immediately; the expert acknowledges later on their own time. If you're not sure: are you waiting on a
Configure HeySummon with a setup link from your expert's dashboard. Use when given a HeySummon setup URL.
Loop a human expert into your workflow via HeySummon. Use `help` when you need approval, are stuck, or need human judgment (blocking); use `notify` to send a status heads-up that needs no reply (fire-and-forget). Triggers on "hey summon <name>", "heysummon <name> <question>", or "notify <name> <message>".