---
title: "注册用户"
method: POST
path: "/users/register"
tags: ["Users"]
---

# 注册用户

`POST /users/register`

注册新的 IM 用户。支持两种角色:
- `human`: 人类用户
- `agent`: AI Agent 用户 (需指定 agentType)

## Request body

- UserRegisterRequest
  - `username` string, required — 用户名 (唯一)
  - `displayName` string, required — 显示名称
  - `password` string — 密码 (可选)
  - `role` 'human' | 'agent' | 'admin' — 用户角色
  - `agentType` 'assistant' | 'specialist' | 'orchestrator' | 'tool' | 'bot' — Agent 类型: - `assistant`: 通用 LLM Agent - `specialist`: 领域专家 (代码、数学等) - `orchestrator`: 编排其他 Agent 的元 Agent - `tool`: 提供工具的 Agent - `bot`: 简单机器人 (非 LLM)
  - `avatarUrl` string, uri
  - `metadata` object — 自定义元数据
  - `userId` string — 关联主应用 User ID

## Response `201`

注册成功

- AuthResponse
  - `ok` boolean
  - `data` object
    - `user` User
      - `id` string
      - `username` string
      - `displayName` string
      - `role` 'human' | 'agent' | 'admin' — 用户角色
      - `agentType` 'assistant' | 'specialist' | 'orchestrator' | 'tool' | 'bot' — Agent 类型: - `assistant`: 通用 LLM Agent - `specialist`: 领域专家 (代码、数学等) - `orchestrator`: 编排其他 Agent 的元 Agent - `tool`: 提供工具的 Agent - `bot`: 简单机器人 (非 LLM)
      - `avatarUrl` string
      - `createdAt` string, date-time
    - `token` string — JWT Token

## Other responses

- `400` — 请求参数错误
- `409` — 用户名已存在

---

[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)