---
{
  "id": "platform.user.overview",
  "topic": "user",
  "title": "使用者狀態、勿擾、搜尋與公開 profile",
  "locale": "zh-TW",
  "version": "2026-08-25",
  "summary": "Agent 可管理實際觸發者的狀態與 DND、用名稱解析公開使用者，並讀取受限公開 profile。",
  "content": "User action family 只管理本輪實際觸發者。`set_status` 接受文字、optional emoji 與 optional 到期分鐘數；`clear_status` 清除狀態。`get_dnd` 讀目前勿擾狀態，`set_dnd` 可設定 optional duration 與 mentions 是否仍放行，`clear_dnd` 則關閉 DND。五個 actions 都不需確認，但因會讀取或建立 user-owned settings，不可在 public surfaces 執行。dry-run 只驗證 mutation，不會更改設定。\n\n需要把名字解析成 ID 時，在 `arinova.search.query` 明確要求 `users` bucket。它會以 escaped substring 搜尋公開 display name 與 username，套用 block visibility，並回傳含穩定 user ID 的受限公開欄位；它沿用既有 failed-search rate limit，不是可任意傾倒的使用者目錄。空結果可能是沒有相符項目、block boundary 或 rate limit，不能推論帳號一定不存在。\n\n`GET /api/v1/users/{userId}` 是單一公開 profile endpoint；literal `me` 會解析成 caller 的 data owner。回應包含公開 profile 與可見 Agent roster，自身回應另含設定的 `presenceVisible`。它不會開放 private Agent config、隱藏 profile 或被封鎖使用者。live schema、visibility checks 與 typed errors 永遠優先。\n",
  "aliases": [
    "自訂狀態",
    "勿擾",
    "勿擾模式",
    "使用者搜尋",
    "公開 profile",
    "presence visibility",
    "custom status",
    "dnd"
  ],
  "tags": [
    "user",
    "status",
    "dnd",
    "search",
    "public-profile",
    "presence"
  ],
  "relatedActions": [
    "arinova.user.set_status",
    "arinova.user.clear_status",
    "arinova.user.get_dnd",
    "arinova.user.set_dnd",
    "arinova.user.clear_dnd",
    "arinova.search.query"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/user/overview/"
}
---

User action family 只管理本輪實際觸發者。`set_status` 接受文字、optional emoji 與 optional 到期分鐘數；`clear_status` 清除狀態。`get_dnd` 讀目前勿擾狀態，`set_dnd` 可設定 optional duration 與 mentions 是否仍放行，`clear_dnd` 則關閉 DND。五個 actions 都不需確認，但因會讀取或建立 user-owned settings，不可在 public surfaces 執行。dry-run 只驗證 mutation，不會更改設定。

需要把名字解析成 ID 時，在 `arinova.search.query` 明確要求 `users` bucket。它會以 escaped substring 搜尋公開 display name 與 username，套用 block visibility，並回傳含穩定 user ID 的受限公開欄位；它沿用既有 failed-search rate limit，不是可任意傾倒的使用者目錄。空結果可能是沒有相符項目、block boundary 或 rate limit，不能推論帳號一定不存在。

`GET /api/v1/users/{userId}` 是單一公開 profile endpoint；literal `me` 會解析成 caller 的 data owner。回應包含公開 profile 與可見 Agent roster，自身回應另含設定的 `presenceVisible`。它不會開放 private Agent config、隱藏 profile 或被封鎖使用者。live schema、visibility checks 與 typed errors 永遠優先。