---
title: "初始化 Workspace"
method: POST
path: "/workspace/init"
tags: ["Workspace"]
---

# 初始化 Workspace

`POST /workspace/init`

为 Workspace 创建 IM 会话，并可选地创建关联的 Agent。
返回用户和 Agent 的 JWT Token，用于后续通信。

## Request body

- object
  - `workspaceId` string, required — Workspace 唯一标识
  - `userId` string, required — 主应用 User ID
  - `userDisplayName` string, required — 用户显示名称
  - `agentName` string — Agent 用户名 (可选)
  - `agentDisplayName` string — Agent 显示名称
  - `agentType` 'assistant' | 'specialist' | 'orchestrator' | 'tool' | 'bot' — Agent 类型: - `assistant`: 通用 LLM Agent - `specialist`: 领域专家 (代码、数学等) - `orchestrator`: 编排其他 Agent 的元 Agent - `tool`: 提供工具的 Agent - `bot`: 简单机器人 (非 LLM)
  - `agentCapabilities` string[] — Agent 能力列表

## Response `201`

初始化成功

- WorkspaceInitResponse
  - `ok` boolean
  - `data` object
    - `conversationId` string — IM 会话 ID
    - `user` object
      - `imUserId` string — IM 用户 ID
      - `token` string — 用户 JWT Token
    - `agent` object, nullable
      - `token` string — Agent JWT Token
      - `agentUserId` string — Agent 用户 ID
      - `conversationId` string
      - `expiresIn` string

## Other responses

- `400` — 请求参数错误
- `401` — 未认证或 Token 无效

---

[API](https://skmtc.net/prismer-ai/apis/prismer-im-server-api.md) · [All operations](https://skmtc.net/prismer-ai/apis/prismer-im-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prismer-ai/prismer-im-server-api/revisions/b27b5d973513/schema)