docs(install): fix repo URL to TencentCloud/, clarify system_admin scope, drop external_id from user create example
This commit is contained in:
parent
531072c3f5
commit
a7d7d852bc
14
INSTALL.md
14
INSTALL.md
@ -19,7 +19,7 @@ consume team memory / knowledge / skills through the proxy:
|
|||||||
|
|
||||||
```bash
|
```bash
|
||||||
# 1) Fetch the scripts
|
# 1) Fetch the scripts
|
||||||
git clone https://github.com/Tencent/TencentDB-Agent-Memory.git
|
git clone https://github.com/TencentCloud/TencentDB-Agent-Memory.git
|
||||||
cd TencentDB-Agent-Memory/deploy/global-images
|
cd TencentDB-Agent-Memory/deploy/global-images
|
||||||
|
|
||||||
# 2) Prepare .env (fill in real LLM values)
|
# 2) Prepare .env (fill in real LLM values)
|
||||||
@ -73,11 +73,11 @@ Open **<http://localhost:8125>** in your browser (Panel UI).
|
|||||||
- The first visit asks for a `user_key` — use the admin one printed at the
|
- The first visit asks for a `user_key` — use the admin one printed at the
|
||||||
end of `start-all.sh` (stored in `deploy/global-images/.admin-key`, a
|
end of `start-all.sh` (stored in `deploy/global-images/.admin-key`, a
|
||||||
`sk-mem-...` string)
|
`sk-mem-...` string)
|
||||||
- Once logged in you are `system_admin`, but at this stage admin can
|
- Once logged in you are `system_admin`. It can **create Teams and
|
||||||
**only manage sub-users** — it **cannot directly own business assets
|
sub-users**, but at this stage **cannot directly create other business
|
||||||
(Team / Agent / Task / Skill)** because the business APIs enforce
|
assets such as Agent / Wiki / Skill** (the business APIs enforce
|
||||||
`owner_user_id === caller` and `system_admin` isn't yet in the allow-list
|
`owner_user_id === caller`, and `system_admin` isn't yet in the
|
||||||
(this restriction will be lifted in a future release).
|
allow-list; this restriction will be lifted in a future release).
|
||||||
- **Correct pattern**: admin creates a `normal` user → copy that user's
|
- **Correct pattern**: admin creates a `normal` user → copy that user's
|
||||||
`user_key` → log out → log back in as the new user → everything from
|
`user_key` → log out → log back in as the new user → everything from
|
||||||
here on (Team / Agent / Task) is owned by the new user.
|
here on (Team / Agent / Task) is owned by the new user.
|
||||||
@ -99,7 +99,7 @@ curl -sS -X POST http://localhost:8420/v3/meta/user/create \
|
|||||||
-H "x-tdai-user-key: $ADMIN_KEY" \
|
-H "x-tdai-user-key: $ADMIN_KEY" \
|
||||||
-H "x-tdai-service-id: default" \
|
-H "x-tdai-service-id: default" \
|
||||||
-H "Content-Type: application/json" \
|
-H "Content-Type: application/json" \
|
||||||
-d '{"username":"you","external_id":"you"}' | jq
|
-d '{"username":"you"}' | jq
|
||||||
```
|
```
|
||||||
|
|
||||||
The response body's `data.default_user_key` (`sk-mem-...`) is the login
|
The response body's `data.default_user_key` (`sk-mem-...`) is the login
|
||||||
|
|||||||
@ -16,7 +16,7 @@
|
|||||||
|
|
||||||
```bash
|
```bash
|
||||||
# 1) 拿脚本
|
# 1) 拿脚本
|
||||||
git clone https://github.com/Tencent/TencentDB-Agent-Memory.git
|
git clone https://github.com/TencentCloud/TencentDB-Agent-Memory.git
|
||||||
cd TencentDB-Agent-Memory/deploy/global-images
|
cd TencentDB-Agent-Memory/deploy/global-images
|
||||||
|
|
||||||
# 2) 准备 .env(把 LLM 相关字段填成真值)
|
# 2) 准备 .env(把 LLM 相关字段填成真值)
|
||||||
@ -67,7 +67,7 @@ $EDITOR .env
|
|||||||
|
|
||||||
- 第一次访问会看到登录页,用 `start-all.sh` 结尾打印的 admin `user_key`
|
- 第一次访问会看到登录页,用 `start-all.sh` 结尾打印的 admin `user_key`
|
||||||
(即 `deploy/global-images/.admin-key` 文件里那串 `sk-mem-...`)登录
|
(即 `deploy/global-images/.admin-key` 文件里那串 `sk-mem-...`)登录
|
||||||
- admin 登录后能**创建子用户**,但目前**不能直接创建 Team / Agent / Task
|
- admin 登录后能**创建 Team 和子用户**,但目前**不能直接创建 Agent / Wiki
|
||||||
/ Skill 等业务资产**(业务侧 API 会做 `owner_user_id === caller` 校验,
|
/ Skill 等业务资产**(业务侧 API 会做 `owner_user_id === caller` 校验,
|
||||||
system_admin 目前不在允许列表里;这层增强会在后续版本放开)
|
system_admin 目前不在允许列表里;这层增强会在后续版本放开)
|
||||||
- **正确姿势**:admin 建一把 `normal` 用户 → 复制新用户的 `user_key` →
|
- **正确姿势**:admin 建一把 `normal` 用户 → 复制新用户的 `user_key` →
|
||||||
@ -90,7 +90,7 @@ curl -sS -X POST http://localhost:8420/v3/meta/user/create \
|
|||||||
-H "x-tdai-user-key: $ADMIN_KEY" \
|
-H "x-tdai-user-key: $ADMIN_KEY" \
|
||||||
-H "x-tdai-service-id: default" \
|
-H "x-tdai-service-id: default" \
|
||||||
-H "Content-Type: application/json" \
|
-H "Content-Type: application/json" \
|
||||||
-d '{"username":"you","external_id":"you"}' | jq
|
-d '{"username":"you"}' | jq
|
||||||
```
|
```
|
||||||
|
|
||||||
返回体里 `data.default_user_key`(`sk-mem-...`)就是新用户的登录 key,
|
返回体里 `data.default_user_key`(`sk-mem-...`)就是新用户的登录 key,
|
||||||
@ -194,6 +194,7 @@ curl -s http://localhost:8420/health | jq .services.pipelineWorker
|
|||||||
所以列表为空。正确做法:先按第 1.5 步建一个业务用户,用它的 `default_user_key`
|
所以列表为空。正确做法:先按第 1.5 步建一个业务用户,用它的 `default_user_key`
|
||||||
作为 `ANTHROPIC_AUTH_TOKEN`。同时那个用户名下必须先在面板里建过 Team/Agent。
|
作为 `ANTHROPIC_AUTH_TOKEN`。同时那个用户名下必须先在面板里建过 Team/Agent。
|
||||||
|
|
||||||
|
|
||||||
**Q: 面板显示"Panel API 8125 未启动"?**
|
**Q: 面板显示"Panel API 8125 未启动"?**
|
||||||
`docker ps` 检查 `tdai-memory-hub` 是不是 healthy;不 healthy 看
|
`docker ps` 检查 `tdai-memory-hub` 是不是 healthy;不 healthy 看
|
||||||
`docker logs tdai-memory-hub` 找报错(大概率是 `REMOTE_INSTANCE_URL` /
|
`docker logs tdai-memory-hub` 找报错(大概率是 `REMOTE_INSTANCE_URL` /
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user