curl -X POST https://agent.tos.run/api/agents \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "客服助手",
    "description": "处理客户常见问题",
    "runtimeType": "langgraph",
    "modelProvider": "openai",
    "modelId": "gpt-4o",
    "systemPrompt": "你是一个专业的客服助手...",
    "greeting": "你好！有什么可以帮助你的？",
    "tools": [],
    "taskCards": [],
    "skills": []
  }'

curl -X POST https://agent.tos.run/api/agent-templates/import \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "variantId": "my-variant",
    "yaml": "name: 客服助手\nruntimeType: langgraph\n..."
  }'

{
  "systemPrompt": "你是公司的智能客服助手。你的职责包括：\n1. 回答产品相关问题\n2. 帮助用户查询订单状态\n3. 处理退换货请求\n\n注意事项：\n- 不要泄露内部定价策略\n- 遇到无法处理的问题，引导用户联系人工客服",
  "personality": "语气友好、耐心，回答专业且易懂。"
}

# 创建凭证
curl -X POST https://agent.tos.run/api/credentials \
  -H "Authorization: Bearer <token>" \
  -d '{
    "name": "OPENAI_API_KEY",
    "value": "sk-xxxxxxxxxxxxxxxx",
    "description": "生产环境 OpenAI Key"
  }'

{ "runtimeType": "langgraph" }

{
  "runtimeType": "sandbox",
  "sandboxConfig": {
    "sandboxTemplateId": "claude-code-template",
    "model": "claude-sonnet-4-20250514",
    "timeout": 300,
    "env": {
      "CUSTOM_VAR": "value"
    }
  }
}

{
  "tools": [
    {
      "id": "tool_query_order",
      "name": "query_order",
      "description": "根据订单号查询订单详情",
      "type": "http",
      "inputSchema": {
        "type": "object",
        "properties": {
          "orderId": {
            "type": "string",
            "description": "订单编号"
          }
        },
        "required": ["orderId"]
      },
      "endpoint": {
        "url": "https://api.example.com/orders/{orderId}",
        "method": "GET",
        "headers": {
          "Authorization": "Bearer {{SERVICE_TOKEN}}"
        }
      }
    }
  ]
}

{
  "id": "tool_create_customer",
  "name": "create_customer",
  "description": "创建新客户",
  "type": "http",
  "integrationId": "integration_erp",
  "openapiSource": {
    "specUrl": "https://api.example.com/openapi.json",
    "operationId": "createCustomer"
  }
}

{
  "taskCards": [
    {
      "title": "查询今日订单",
      "description": "查询今天所有新建的订单",
      "prompt": "请帮我查询今天创建的所有订单，按金额从高到低排列",
      "icon": "ShoppingCart"
    },
    {
      "title": "生成周报",
      "description": "根据本周数据生成业务周报",
      "prompt": "请根据本周的业务数据生成一份周报，包括销售额、新客户数、订单完成率",
      "icon": "FileText"
    },
    {
      "title": "客户分析",
      "description": "分析指定客户的历史交易",
      "prompt": "请帮我分析当前客户的历史交易数据，给出趋势和建议",
      "icon": "BarChart3"
    }
  ]
}

{
  "id": "skill_frontend_dev",
  "name": "前端开发助手",
  "description": "React/TypeScript/CSS 专家",
  "icon": "Code",
  "category": "开发",
  "keywords": ["react", "typescript", "前端"],
  "instructions": "你是一名资深前端开发工程师，精通 React 18+...",
  "tools": []
}

{
  "skills": [
    "skill_frontend_dev",
    "skill_data_analyst",
    {
      "id": "custom_skill",
      "name": "自定义业务技能",
      "description": "处理特定业务逻辑",
      "instructions": "你了解我们公司的业务流程..."
    }
  ]
}

# 列出所有技能（组织内 + 公开市场）
GET /api/skills

# 获取技能详情
GET /api/skills/:id

# 创建技能
POST /api/skills

# 更新技能
PATCH /api/skills/:id

# 删除技能
DELETE /api/skills/:id

{
  "id": "mcp_github",
  "orgId": "org-123",
  "name": "GitHub MCP",
  "serverKey": "github",
  "config": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-github"],
    "env": {
      "GITHUB_PERSONAL_ACCESS_TOKEN": "{{GITHUB_TOKEN}}"
    }
  },
  "enabled": true
}

{
  "mcpServers": [
    {
      "serverKey": "github",
      "config": {},
      "enabled": true
    },
    {
      "serverKey": "slack",
      "config": {
        "env": { "SLACK_TOKEN": "{{SLACK_BOT_TOKEN}}" }
      },
      "enabled": true
    }
  ]
}

# 列出组织内所有 MCP Server
GET /api/mcp-servers

# 创建 MCP Server
POST /api/mcp-servers

# 更新 MCP Server
PATCH /api/mcp-servers/:id

# 删除 MCP Server
DELETE /api/mcp-servers/:id

{
  "greeting": "你好！我是你的业务助手，可以帮你：\n\n- 📊 查询和分析订单数据\n- 👥 管理客户信息\n- 📝 生成业务报告\n\n请问有什么需要帮助的？"
}

根节点 (root)
├── 销售部
│   ├── 华东区
│   │   ├── 客服助手 (agent)
│   │   └── 销售分析 (agent)
│   └── 华南区
│       └── 客服助手 (agent)
└── 技术部
    ├── 代码审查助手 (agent)
    └── 文档助手 (agent)

{
  "name": "销售部",
  "defaultSystemPrompt": "你是销售部门的 AI 助手，了解公司产品线和定价策略...",
  "skills": ["skill_sales_expert"]
}

# 获取组织树
GET /api/org-units/tree

# 创建组织单元
POST /api/org-units
{ "name": "华东区", "parentId": "unit-sales" }

# 更新组织单元
PATCH /api/org-units/:id
{ "defaultSystemPrompt": "...", "skills": ["skill_id_1"] }

# 删除组织单元
DELETE /api/org-units/:id

# 查看智能体的分享列表
GET /api/agents/:id/shares

# 添加分享（授予权限）
POST /api/agents/:id/shares
{
  "subjectId": "user-456",
  "relation": "editor"
}

# 移除分享（撤销权限）
DELETE /api/agents/:id/shares
{
  "subjectId": "user-456",
  "relation": "editor"
}

# 列出智能体
GET /api/agents

# 获取智能体详情
GET /api/agents/:id

# 创建智能体
POST /api/agents

# 更新智能体
PATCH /api/agents/:id

# 删除智能体
DELETE /api/agents/:id