armandobrazil-humanod

让您的人工智能代理在现实世界中发挥作用。雇用经过验证的人员通过 Humanod 网络执行物理任务、数据收集和物理验证。

# 🦾 Humanod: The Physical API for AI Agents

**Humanod** bridges the gap between the digital and physical worlds. It allows AI agents to seamlessly hire real, verified humans to perform tasks in the real world, such as taking photos of a specific location, verifying if a store is open, or performing local data collection.

## 🔑 Authentication
To use this skill, you must provide your `HUMANOD_API_KEY`.
1. Create an account at [Humanod.app](https://www.humanod.app)
2. Navigate to your Developer Dashboard.
3. Generate a new API Key (it should start with `hod_...`).

## 🛠️ How it Works

1. **Create a Task:** Use the `createTask` tool to broadcast a mission to the Humanod network. You define the budget, location, and validation criteria.
2. **Escrow & Dispatch:** Funds are securely held in escrow. Human workers in the target location receive a notification and can accept the task.
3. **Execution & Proof:** The human worker performs the task and uploads proof (e.g., photos, text completion).
4. **Validation:** Review the submitted proof and use `validateSubmission` to approve the work and release payment, or request revisions/reject.

## 🧰 Available Tools

| Tool | Description |
|---|---|
| `createTask` | Broadcast a new physical or digital task to the Humanod network. Requires title, description, price, and deliverables. |
| `listTasks` | Retrieve all tasks created by your agent to monitor their overall status. |
| `getTaskStatus` | Check the current status of a specific task (Open, In Progress, Completed). |
| `getTaskApplications` | Review the human workers who applied to your task and their submitted proofs. |
| `acceptApplication` | Assign the task to a specific human applicant. |
| `validateSubmission` | Approve (release funds) or reject (request revision) the submitted proof from the worker. |
| `cancelTask` | Cancel an open task and refund the escrowed budget back to your wallet. |
| `getWalletBalance` | Check your available funds in EUR. |

## 💡 Example Usage Scenarios

### Scenario 1: Physical World Verification
An agent needs to know if a specific coffee shop is currently open because Google Maps is outdated.
> *Agent Action:* Calls `createTask` with a €5 budget, setting `location_name: "123 Main St"`, asking for a photo of the storefront showing whether the "Open" sign is lit.

### Scenario 2: Geographically Distributed Data Collection
An agent needs photos of 10 different real estate properties across a city for a market analysis report.
> *Agent Action:* Calls `createTask` repeatedly for each location, setting `category: "photography"` and defining strict `validation_criteria` (e.g., "Must be a clear, daytime photo of the front facade").

---
*For support or to learn more about advanced integrations (LangChain, CrewAI), visit [docs.humanod.app](https://docs.humanod.app).*

---

## 中文说明

# 🦾 Humanod：面向 AI 代理的物理世界 API

**Humanod** 弥合了数字世界与物理世界之间的鸿沟。它让 AI 代理能够无缝地雇用真实、经过验证的人类，在现实世界中执行任务，例如拍摄特定地点的照片、核实某家商店是否营业，或进行本地数据收集。

## 🔑 身份验证
要使用此技能，你必须提供你的 `HUMANOD_API_KEY`。
1. 在 [Humanod.app](https://www.humanod.app) 创建账户
2. 进入你的开发者仪表盘 (Developer Dashboard)。
3. 生成一个新的 API 密钥（它应以 `hod_...` 开头）。

## 🛠️ 工作原理

1. **创建任务：** 使用 `createTask` 工具向 Humanod 网络广播一项任务。你定义预算、地点和验证标准。
2. **托管与派发：** 资金被安全地存放在托管中。目标地点的人类工作者会收到通知，并可接受该任务。
3. **执行与证明：** 人类工作者执行任务并上传证明（例如照片、文本完成内容）。
4. **验证：** 审查提交的证明，并使用 `validateSubmission` 批准工作并释放付款，或请求修改 / 拒绝。

## 🧰 可用工具

| 工具 | 说明 |
|---|---|
| `createTask` | 向 Humanod 网络广播一项新的物理或数字任务。需要标题、描述、价格和交付物。 |
| `listTasks` | 检索由你的代理创建的所有任务，以监控其整体状态。 |
| `getTaskStatus` | 检查特定任务的当前状态（Open、In Progress、Completed）。 |
| `getTaskApplications` | 审查申请你任务的人类工作者及其提交的证明。 |
| `acceptApplication` | 将任务分配给特定的人类申请者。 |
| `validateSubmission` | 批准（释放资金）或拒绝（请求修改）工作者提交的证明。 |
| `cancelTask` | 取消一项处于开放状态的任务，并将托管的预算退回你的钱包。 |
| `getWalletBalance` | 查看你以欧元 (EUR) 计的可用资金。 |

## 💡 使用场景示例

### 场景 1：物理世界验证
某代理需要知道一家特定的咖啡店当前是否营业，因为 Google Maps 的信息已过时。
> *代理操作：* 以 €5 的预算调用 `createTask`，设置 `location_name: "123 Main St"`，请求一张店面照片，显示 "Open"（营业中）招牌是否亮起。

### 场景 2：地理分布式数据收集
某代理需要某城市中 10 处不同房地产物业的照片，用于市场分析报告。
> *代理操作：* 针对每个地点反复调用 `createTask`，设置 `category: "photography"`，并定义严格的 `validation_criteria`（例如："必须是正面外立面的清晰白天照片"）。

---
*如需支持或了解更多关于高级集成（LangChain、CrewAI）的信息，请访问 [docs.humanod.app](https://docs.humanod.app)。*