Operis

Operis

🎬 我们的黑客马拉松演示

这是我们提交给 Naïve × YC Autonomous Companies Hackathon 的演示视频（2:00）。

▶️ 观看演示（MP4）

视频展示了：一家由 Naïve 运营的公司需要有人才能完成的任务，于是它的 Agent 向 Operis 调用一次接口，说明任务、预算以及完成标准。Operis 找到一位真人并发出邀请，对方接受这份工作并在现实世界中完成任务。Operis 核验其证明后向其付款。整个过程无需 Operis 的任何员工介入。

📑 演示幻灯片

我们演示时使用的幻灯片（15 页）：团队、问题、一次调用如何变成经过核验并获得报酬的人工行动、发展机遇和我们的愿景。

📄 打开幻灯片（PDF）

🗺️ 初次使用？请从 docs/FLOW.md 开始：了解完整的任务流程、每个步骤的负责人，以及应该在哪个文件夹中进行修改。

🤖 想让你的 Agent 雇用真人？ 在 https://operis.live/developers 获取密钥，或阅读 docs/CONNECT.md（在线版：https://operis.live/llms.txt）。

🧪 正在测试？ docs/TEST_PLAN.md · 🚀 要在生产环境中运行？ docs/GO_LIVE.md

在线服务

URL	内容
https://operis.live	网站（Dora 的应用）：首页、工人任务页面 /j/<token>、/jobs、/dashboard
https://operis.live/developers	Agent 公司：自助获取 API 密钥、连接说明、可直接复制粘贴的 Agent 提示词、密钥测试
https://admin.operis.live	创始人：按公司查看实时请求、Agent 活动和证明（使用创始人邮箱登录）
https://operis.live/mcp	公共 MCP 服务（request_human、get_job、cancel_job），通过代理连接到 API
https://operis.live/llms.txt	面向 Agent 的指南
https://api.operis.live	API 本身（MCP、REST、webhooks）；创始人控制台位于 /admin

将此内容提供给你的 Agent： set up https://operis.live/SKILL.md（它会为你注册、保存密钥并建立连接）。

无需密钥即可连接任何 AI 应用： 将 https://operis.live/mcp 添加为连接器 / MCP 服务（Claude.ai、ChatGPT、Claude Code、Cursor、VS Code），并在出现提示时登录（OAuth）。

在 Claude Code 中使用 Operis（MCP 服务 +「hire-a-human」技能），并在环境中设置从 https://operis.live/developers 获取的 OPERIS_API_KEY：

/plugin install operis --marketplace cubic1M/Naive-Autonomous-Company-Hackathon-Project

为自主运营的公司随时提供真人。 由 AI 运营的公司通过我们的 MCP 服务请求真人。Operis 在线寻找合适的人选，通过他们主动公开的联系方式联系对方，并向完成任务的人付款。工人无需提前注册。

在 Naïve × YC Autonomous Companies Hackathon 上构建。Operis 本身也是一家自主运营的公司：六个 Naïve Agent（CEO、Ops、Verifier、Finance、Sales、Disputes）在 Operis Naïve 组织中运营它，创始人只负责设定限制并批准重大决策。

---

工作原理

Autonomous company ──MCP──▶ Operis API ──▶ Naïve agents (CEO, Ops, Verifier, Finance)
                                                 │
                                   1. find people near the job (web scraping)
                                   2. message them via their public contact
                                                 ▼
                              Human clicks link ──▶ Operis job page
                                                 │  Accept / Decline
                                                 │  Upload proof (photo / video / file)
                                                 ▼
                              Verifier checks proof ──▶ Customer charged ──▶ Worker paid

1. 请求。 客户 Agent 使用任务、地点、截止时间、预算、所需认证以及所需证明，调用我们 MCP 服务上的 request_human。
2. 安全检查。 我们会拒绝非法、冒充身份、监控或需要执照的工作。对于有争议的请求，会交由创始人处理。
3. 暂扣款项。 暂扣客户的银行卡款项，但不扣款（Stripe，手动捕获）。
4. 寻找人员。 抓取程序会从公开的工作相关来源寻找工作地点附近的人员：零工平台、校园招聘板、企业名录和过往工作人员。
5. 联系人员。 我们会使用对方自行公开的联系信息（电子邮件、短信等），附上工作页面链接，同时向许多人发送消息。首位接受的人获得这份工作。每条消息都包含退订选项。
6. 工作页面。 工作人员会看到工作说明、报酬、地点和所需认证，然后点击 是 或 否。如有需要，他们可以上传认证等额外信息。
7. 证明。 完成工作后，他们会上传工作要求的证明：照片、视频或文档，并附上 GPS 信息和时间戳。
8. 验证。 验证 Agent 会根据请求检查证明。有把握时会予以批准；否则由人工审核员决定。
9. 付款。 客户的银行卡会被扣款。工作人员只需在首次收款时关联一次银行账户，即可收到应得款项。我们保留手续费。

费用

• 工作人员无需付费。 无需注册，也不收取费用。
• 客户只需为已完成的工作付费。 预先暂扣银行卡款项，仅在证明通过后扣款。如果工作未通过，暂扣款项会被释放。
• 我们的抽成： 工作价格的 25%（工作最低价格为 $20）。例如，一项 $60 的工作会向工作人员支付 $45，Operis 保留 $15。

MCP 工具（供客户 Agent 使用）

工具	功能
request_human	发布工作：任务、地点、截止时间、预算、认证、证明要求
get_job	获取状态，以及批准后提供的证明包
cancel_job	在有人接受之前取消工作

请求示例：

{
  "title": "Photograph the Ferry Building entrance and posted hours",
  "instructions": "Stand in front of the main entrance on The Embarcadero. Take one photo of the entrance and one close-up of the posted hours.",
  "location": { "address": "1 Ferry Building, San Francisco, CA 94111", "lat": 37.7955, "lng": -122.3935 },
  "deadline": "2026-11-08T14:00:00-08:00",
  "budget_usd": 60,
  "certification_required": null,
  "proof": { "photos": { "min": 2, "must_show": ["main entrance", "posted hours"] } }
}

Agent 团队（朴素版）

Agent	职责
CEO	管理看板、分配每项工作、负责损益和争议，并向创始人提交每日报告
Ops	运行抓取程序、发送联系消息，并选出接受工作的人员
Verifier	检查证明（视觉模型 + GPS）；批准或上报
Finance	负责暂扣款项、扣款、付款、退款和账簿
Sales	帮助其他团队的 Agent 接入我们的 MCP 服务

创始人设定的限制： 每个 Agent 均设有每日支出上限；超过 $150 的退款和付款需要 CEO Agent 批准；超过 $1,000 的事项以及任何法律或安全问题，都必须交由创始人处理；工作范围仅限演示区域（旧金山）。

团队分工

角色	负责人	开发内容
前端	Dora	工作人员网站：工作页面（说明、报酬、认证、是/否）、上传表单、带 GPS 的证明上传、收款设置页面，以及实时仪表板（地图、实时工作、Agent 动态、资金）
抓取与联系	Andrew	查找地点附近的人员、提取公开联系信息、发送“群发”消息（电子邮件 / 短信）、首位确认者优先逻辑、常客名单
验证与付款	Cameron	证明检查（GPS 距离、时间戳、使用视觉模型审核图像/视频）、批准/上报流程、Stripe 暂扣 → 扣款 → 付款至银行账户
朴素版 Agent 与 MCP	Edwin	MCP 服务和 API、数据库、五个朴素版 Agent（提示词、预算、工具权限、团队看板），以及将所有组件连接起来

共同约定： 所有人都基于相同的 jobs / workers / proofs 表和下方的工作状态进行开发。只有在团队达成一致后才能修改它们。

requested → held → outreach → accepted → proof_submitted → approved → paid
                                                         ↘ escalated / rejected
(also: cancelled, expired, refunded)

技术栈

层	工具
Agent	Naïve Managed Agents（@usenaive-sdk/managed-agents、naive CLI）
API + MCP 服务	Vercel 上的 TypeScript（@modelcontextprotocol/sdk）
数据库	Postgres（Neon，或 Naïve 全栈应用）
收款 + 付款	Stripe Checkout（手动捕获）+ Stripe Connect Express
消息	Twilio SMS + 通过 Naïve 收件箱发送电子邮件
凭证存储	Vercel Blob（或 Naïve 应用存储）
视觉	通过 Naïve 模型路由器调用视觉模型

我们遵循的规则

• 仅使用公开的工作相关联系信息。 我们不会购买或挖掘个人数据。我们联系的每个人都可以选择退出；一旦选择退出，我们就不会再联系他们。
• 不处理身份验证。 人类绝不会签署合同、通过 CAPTCHA、接收 OTP，也不会冒充 Agent。
• 不将需持证的建议作为我们的服务出售。 如果工作需要资质认证，工作人员必须出示资质，并以自己的名义完成工作。
• 每项工作都经过验证。 付款前必须提供 GPS、时间戳和凭证。

开始使用

npm install                                   # repo root: npm workspaces (apps/*, services/outreach, services/money-verification)
docker run -d --name operis-pg -e POSTGRES_PASSWORD=dev -e POSTGRES_DB=operis -p 55433:5432 postgres:17
cp apps/api/.env.example apps/api/.env.local  # fill in secrets (see apps/api/README.md)
npm run db:migrate                            # all migrations (shared schema, API, outreach, money-verification)
npm run dev                                   # API on http://localhost:3001
cd apps/web && cp .env.example .env.local && npx next dev -p 3100   # website on http://localhost:3100 (proxies /api → :3001)
npm run smoke                                 # 20 end-to-end checks against the API

实用脚本：npm run approvals（为 Naïve Agent 批准创始人权限）、npm run agents:setup（将 agents/agents.json 应用到 Naïve）、npm run simulate -- <job_id>（模拟工作人员）、npm run customer:create。

完整流程、所有权和构建顺序：docs/FLOW.md。共享契约：contracts/。生产环境设置：docs/GO_LIVE.md。