human-interaction

Poll workspace state and submit human input via a respond endpoint.

2|Updated Jan 27, 2026

Search Tags:#workflow automation #agent communication #decision support #human-in-the-loop #api interaction

Ready to run

npx skills add https://github.com/ucirello/sgai --skill human-interaction-ucirello

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: human-interaction
Source: https://github.com/ucirello/sgai/tree/main/docs/sgai-skills/human-interaction
Command: npx skills add https://github.com/ucirello/sgai --skill human-interaction-ucirello

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill enables smooth communication between AI agents and human users, ensuring that AI processes are unblocked when human input, decisions, or approvals are required.

Core Features & Use Cases

Agent Question Handling: Responds to free-text questions, multi-choice selections, and work-gate approvals.
Workspace Monitoring: Detects when an agent is waiting for human input by polling the workspace state.
Use Case: When an AI agent needs to know which database to use for a project, this Skill allows a human to provide the answer through a simple API call, unblocking the agent and allowing development to continue.

Quick Start

Respond to the pending question in the 'my-project' workspace with the answer "This is a B2B SaaS platform for small businesses".

Frequently Asked Questions about human-interaction

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

FAQPage Schema

How do I handle human-in-the-loop approvals in an AI agent workflow?▼

Human-in-the-loop approvals are managed by polling workspace state to detect pending work gates, then submitting human input through a dedicated respond endpoint to unblock and progress the AI agent workflow.

What types of human input can AI agents request during workflow automation?▼

AI agents can request free-text answers and multi-choice selections during workflow automation, allowing human users to provide specific information or select from predefined options to resolve pending questions.

How does an AI agent know when to wait for human decision support?▼

An AI agent knows to wait for human decision support by monitoring the workspace state; polling detects when the agent is blocked and requires human input, decisions, or approvals to continue processing.

Can I use API interaction to submit free-text answers to pending agent queries?▼

Yes, you can use a dedicated API respond endpoint to submit free-text answers to pending agent queries, ensuring the workflow receives the exact human input needed to proceed with its automated tasks.

What is the best way to unblock an AI agent waiting for a database selection?▼

The best way to unblock an AI agent waiting for a database selection is to poll the workspace state for the pending question and submit the human decision via the API respond endpoint to resume development.

Does workflow automation with human interaction require continuous workspace polling?▼

Yes, detecting when an agent requires human interaction requires polling the workspace state to identify pending questions or work gates, ensuring workflow automation pauses appropriately until human input is submitted.