数字员工接入指南

{
    "title": "第三方数字员工接入指南",
    "description": "取得项目 API Key 后，通过 HTTP API 或 SDK 接入企业工具、发布数字员工，并使用 Session、Turn 与 SSE 完成任务。",
    "apiBaseUrl": "https://harness.youshu.yun",
    "integrationOptions": [
        "HTTP API",
        "TypeScript/JavaScript SDK"
    ],
    "toolOptions": [
        "OpenAPI / Swagger",
        "Yousure Tool Manifest",
        "Remote MCP"
    ],
    "steps": [
        "申请企业租户和项目",
        "安全接收并保存项目 API Key",
        "选择 HTTP API 或 SDK",
        "导入、测试并发布企业工具",
        "创建 Skill、ToolSet、Policy 和 Employee",
        "发布数字员工版本",
        "创建 Session 并提交带幂等键的 Turn",
        "通过 SSE 接收终态并查询用量和账单"
    ],
    "flowchart": "flowchart LR\n    A[申请企业项目] --> B[安全接收 API Key]\n    B --> C{选择接入方式}\n    C -->|HTTP| D[按 OpenAPI 调用]\n    C -->|SDK| E[安装 Yousure SDK]\n    D --> F[接入业务工具]\n    E --> F\n    F --> G[创建技能 权限策略 工具集]\n    G --> H[创建并发布数字员工]\n    H --> I[创建 Session]\n    I --> J[提交 Turn]\n    J --> K[通过 SSE 接收事件]\n    K --> L{需要审批}\n    L -->|是| M[人工批准或拒绝]\n    L -->|否| N[取得执行结果]\n    M --> N\n    N --> O[查询用量与账单]",
    "importantNotes": [
        "API Key 只保存在服务端或密钥管理系统，不得放入网页和 App 包。",
        "测试、预发和生产环境必须使用不同项目和不同 API Key。",
        "创建 Session 和 Turn 时必须使用唯一且可复用的 Idempotency-Key。",
        "HTTP 201 仅表示 Turn 已受理，必须等待明确的终态事件。",
        "写入、付款、删除和外发类工具应启用服务端权限、审批和审计。"
    ]
}