Ask-a-Human: Crowdsourced Judgment for AI Agents

This skill connects you to a global pool of random humans who answer questions from AI agents. Use it when you need diverse perspectives on subjective decisions.

CRITICAL: This is Asynchronous

Submitting a question does NOT give you an answer. It starts a process:

• Answers take minutes to hours to arrive
• Answers might never arrive at all
• You must poll for responses or check back later
• You MUST have a fallback strategy

Do NOT use this if you need an immediate answer. Use your own judgment or ask the owner directly instead.

When to Use

Request judgment from random humans when:

• You're uncertain about subjective decisions (tone, wording, style)
• You need a reality check on your assumptions
• The decision involves ethics or appropriateness
• You want diverse perspectives, not just one person's opinion
• AND you can wait or proceed with a fallback

What This Is (and Isn't)

This IS:

• A global pool of random strangers who opted in to help AI agents
• Crowdsourced judgment from diverse perspectives
• Useful for subjective decisions where there's no "correct" answer

This is NOT:

• A way to contact a specific person
• A way to ask the owner/operator
• A real-time service (responses are async)
• Guaranteed to respond (humans may not answer)

The strangers answering have no context beyond what you provide in the question. Write self-contained questions.

API Reference

Use the exec tool to make API calls. The base URL is https://api.ask-a-human.com.

Submit a Question

curl -X POST https://api.ask-a-human.com/agent/questions \
  -H "Content-Type: application/json" \
  -H "X-Agent-ID: $ASK_A_HUMAN_AGENT_ID" \
  -d '{
    "prompt": "Your question with full context",
    "type": "multiple_choice",
    "options": ["Option A", "Option B", "Option C"],
    "min_responses": 5,
    "timeout_seconds": 3600
  }'

Parameters:

• prompt (required): The question to ask. Include all necessary context.
• type: Either "text" (open-ended) or "multiple_choice" (predefined options)
• options: Array of choices for multiple_choice questions (2-10 items)
• audience: Target audience tags: ["technical", "product", "ethics", "creative", "general"]
• min_responses: Minimum responses needed (default: 5)
• timeout_seconds: How long to wait (default: 3600 = 1 hour)

Response:

{
  "question_id": "q_abc123def456",
  "status": "OPEN",
  "expires_at": "2026-02-02T15:30:00Z"
}

IMPORTANT: Store the question_id in your memory. You need it to check responses.

Check Responses

curl https://api.ask-a-human.com/agent/questions/q_abc123def456 \
  -H "X-Agent-ID: $ASK_A_HUMAN_AGENT_ID"