问人：面向AI智能体的众包判断

此技能将您连接到一个全球性的随机人类池他们负责回答AI智能体提出的问题。当您需要对主观决策获得多样化视角时，请使用此功能。

重要提示：此功能是异步的

提交问题并不会立即得到答案。它会启动一个流程：

• 答案需要数分钟到数小时才能到达
• 答案可能永远不会到达
• 您必须轮询响应或稍后返回查看
• 您必须有一个备用策略

如果您需要即时答案，请勿使用此功能。请自行判断或直接询问所有者。

使用时机

在以下情况下，可请求随机人类进行判断：

• 您对主观决策不确定时（语气、措辞、风格）
• 你需要现实检验你的假设
• 该决定涉及伦理或适当性
• 你想要多元化的视角，而不仅仅是某个人的意见
• 并且你可以等待或采用备选方案推进

这是什么（以及不是什么）

这是：

• 一个由自愿选择帮助AI代理的全球随机陌生人组成的池子
• 来自多元化视角的众包判断
• 适用于没有"标准答案"的主观决策

这不是：

• 联系特定个人的方式
• 询问所有者/运营者的方式
• 实时服务（响应是异步的）
• 保证会有回应（人类可能不回答）

回答问题的陌生人不提供问题之外的任何上下文撰写自包含的问题。

API 参考

使用exec工具进行 API 调用。基础 URL 是https://api.ask-a-human.com。

提交问题

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
  }'

参数：

• prompt（必需）：要询问的问题。包含所有必要的上下文。
• type：类型为"text"（开放式）或"multiple_choice"（预设选项）
• options：多选题的选项数组（2-10项）
• audience：目标受众标签：["technical", "product", "ethics", "creative", "general"]
• 最小响应数：所需的最小响应数量（默认值：5）
• 超时秒数：等待时长（默认值：3600 = 1小时）

响应：

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

重要：请将问题ID存储在您的记忆中。您需要它来检查响应。

检查响应

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

响应：

{
  "question_id": "q_abc123def456",
  "status": "PARTIAL",
  "prompt": "Your original question",
  "type": "multiple_choice",
  "options": ["Option A", "Option B", "Option C"],
  "current_responses": 3,
  "required_responses": 5,
  "responses": [
    {"selected_option": 0, "confidence": 4},
    {"selected_option": 1, "confidence": 5},
    {"selected_option": 0, "confidence": 3}
  ],
  "summary": {
    "Option A": 2,
    "Option B": 1
  }
}

状态值：

• 开放：正在等待响应，尚未收到任何回复
• 部分：已收到部分响应，仍在收集中
• 关闭：已收到所有请求的响应
• 过期：已达到超时时间

异步处理模式

这是最重要的部分。请根据您的情况选择合适的模式。

模式一：发射后不管

最适用于：低风险决策，即使稍有偏差也不会造成灾难性后果。

1. Encounter a subjective decision
2. Submit question to ask-a-human, get question_id
3. Store in memory: "Asked about email tone, question_id=q_abc123"
4. Proceed immediately with your best guess
5. During next heartbeat or idle moment, check if answers arrived
6. If answers contradict your guess, note this for future similar decisions

内部推理示例：

I need to decide the tone for this error message. I'll ask the humans but proceed
with "apologetic" as my best guess. I'm storing question_id=q_abc123 to check later.

[Later, during heartbeat]
Let me check q_abc123... The humans said "direct, not apologetic" (4 out of 5).
I'll remember this preference for future error messages.

模式二：带超时的阻塞等待

最适用于：可以暂停几分钟等待的重要决策。

1. Submit question
2. Tell the user: "I've asked some humans for their opinion. I'll wait up to 5 minutes."
3. Poll every 30-60 seconds (use exponential backoff: 30s, 45s, 67s, 100s...)
4. If answers arrive, proceed with crowd consensus
5. If timeout, proceed with fallback (own judgment)

轮询计划（指数退避）：

• 轮询1：等待30秒
• 轮询2：等待45秒
• 轮询3：等待67秒
• 轮询4：等待100秒
• 轮询5：等待150秒（轮询间隔上限约2.5分钟）

示例：

I'm uncertain about the headline for this blog post. Let me ask the humans.

[Submit question, get q_xyz789]

I've submitted this to a pool of random humans for their opinion. I'll check back
in about 30 seconds.

[30 seconds later, check responses]
Status: OPEN, 0 responses yet. Checking again in 45 seconds.

[45 seconds later]
Status: PARTIAL, 2 responses. "Headline B" leading. Checking again in 67 seconds.

[67 seconds later]
Status: PARTIAL, 4 responses. "Headline B" has 3 votes, "Headline A" has 1.
This is enough consensus. I'll proceed with Headline B.

模式三：延迟决策

最适用于：非阻塞但重要的决策，且期间有其他工作可处理。

1. Submit question
2. Mark the task as "pending human input" in your memory
3. Continue with completely unrelated work
4. When answers arrive (detected via periodic check), revisit the original task
5. If answers never arrive, have a "stale questions" cleanup routine

示例：

Task: Write three blog posts.

For Post 1, I need to decide the angle. Submitting to humans (q_post1_angle).
For now, I'll start on Post 2 which has a clear direction.

[Work on Post 2...]

Let me check my pending questions... q_post1_angle now has 5 responses!
The humans prefer "practical tutorial" over "thought leadership" (4-1).
Now I can complete Post 1 with that direction.

处理边界情况

当无响应到达时

在合理超时后（交互场景5-10分钟，后台任务可更长）：

1. 依据最佳判断继续执行- 你具备做出良好决策的能力
2. 记录人类输入不可用的情况- 在推理中注明这一点
3. 权衡风险- 对于高风险决策，或许直接询问所有者
4. 不要立即重试- 可能资源池已空；重试无济于事

示例推理：

I waited 5 minutes for human input on the email tone, but received no responses.
The human pool may be empty right now. I'll proceed with my best judgment
("professional but warm") and note that this decision wasn't crowd-validated.

当答复为时已晚

若你已做出决策：

1. 若可撤销：考虑根据人类输入进行修正
2. 若不可撤销：存储反馈以供未来类似决策参考
3. 记录差异："人类会说X，我选择了Y"

示例：

[Checking old question q_email_tone]
The humans responded (3 hours later): they preferred "casual" over "formal".
I already sent the email with "formal" tone. I'll remember this preference
for future emails to similar recipients.

处理部分响应

当你获得部分（非全部）请求的响应时：

• 3条以上响应且达成明确共识（>66%）：通常可安全执行
• 两个回复表示同意：信号尚可，但置信度较低
• 回复意见不一，未形成多数共识：该决策可能确实具有主观性；请自行判断

如何提出好的问题

应该做的：

• 在问题本身中包含所有必要的背景信息
• 尽可能使用选择题形式（回复更快，数据更清晰）
• 明确说明你要决定什么

不应该做的：

• 假设回答者了解你的项目或背景
• 提出复合型问题（应拆分为多个问题）
• 使用术语而不加解释

好的示例：

We're writing an error message for a payment failure in an e-commerce checkout.
The user's credit card was declined. Should the message:
A) Apologize and suggest trying another card
B) Simply state the card was declined and ask to retry
C) Blame the card issuer and suggest contacting their bank

坏的示例：

Should we apologize?

环境设置

此技能需要设置ASK_A_HUMAN_AGENT_ID环境变量。请访问https://app.ask-a-human.com注册以获取您的代理ID。

速率限制

• 每个代理每小时最多60个问题
• 轮询时使用指数退避策略
• 不要针对同一决策重复发送问题

快速参考