human-interaction

Handle pending sgai agent questions and work-gate approvals via REST endpoints.

130|8|Updated Jan 23, 2026
One-click install
npx skills add https://github.com/sandgardenhq/sgai --skill human-interaction
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: human-interaction
Source: https://github.com/sandgardenhq/sgai/tree/main/docs/sgai-skills/human-interaction
Command: npx skills add https://github.com/sandgardenhq/sgai --skill human-interaction

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Agents in sgai often pause awaiting human input, causing delays. This skill provides a systematic way to detect pending questions, answer free‑text, select choices for multi‑choice queries, and approve work‑gate decisions, keeping the workflow moving.

Core Features & Use Cases

  • Detect pending questions across workspaces via the state API.
  • Respond to free‑text, multi‑choice, and work‑gate questions through the respond endpoint.
  • Delete messages from a workspace’s queue when needed.
  • Ideal for developers supervising sgai runs, ensuring timely human approvals and inputs.

Quick Start

Use the human interaction skill to respond to pending sgai workspace questions and approve work gates.

Frequently Asked Questions about human-interaction

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

FAQPage Schema
How do I respond to pending agent questions in an sgai workspace?

To respond to pending agent questions in an sgai workspace, use the skill to detect queries via the state API and submit answers through the /api/v1/workspaces/{name}/respond endpoint. It supports free-text, multi-choice, and work-gate approvals.

What is a work-gate approval in sgai automation?

A work-gate approval in sgai automation is a paused workflow state where an agent requires explicit human authorization to proceed. This skill detects these pending work-gate decisions and submits approvals via the respond endpoint to resume the automated process.

How do I detect if an sgai agent needs human input?

You detect if an sgai agent needs human input by checking the state API for workspaces where the agent sets needsInput to true and exposes a pendingQuestion. This skill systematically queries that state to identify paused runs awaiting action.

Can I delete pending messages from an sgai workspace queue?

Yes, you can delete pending messages from an sgai workspace queue. Along with answering free-text and multi-choice questions, the skill provides functionality to remove messages from the queue when needed to manage workflow state.

Do I need specific API access to handle sgai agent questions?

Yes, handling sgai agent questions requires access to the sgai REST endpoints /api/v1/state and /api/v1/workspaces/{name}/respond. These endpoints are necessary to detect pending questions and submit answers or selected choices across workspaces.

What types of agent questions can I answer through the sgai respond endpoint?

Through the sgai respond endpoint, you can answer free-text queries, select choices for multi-choice questions, and approve work-gate decisions. This covers the pending question types agents expose via the state API.