---
{
  "id": "platform.search.overview",
  "topic": "search",
  "title": "已授權站內搜尋概觀",
  "locale": "zh-TW",
  "version": "2026-08-25",
  "summary": "Search 依明確 buckets 查詢使用者已授權的 Arinova 站內資源，不會存取公開網路。",
  "content": "`arinova.search.query` 在 Arinova 站內搜尋，wire contract 只有七個 buckets：`messages`、`notes`、`memo`、`kanban`、`conversations`、`users`、`memory`。每次呼叫都必須提供非空的 `scopes` array，沒有隱含「全部」，Agent 也不可自創 scope。只選需求實際涉及的 buckets，欄位與 limit 細節再依 live schema。`users` bucket 會以 escaped public display name 或 username 搜尋，在 failed-search rate limit 下回傳受限公開欄位與穩定 ID。\n\n每個 bucket 都各自執行 domain permission checks，只回 Agent 有權讀取的 resources；result snippets 有長度上限。`memory` bucket 是 Agent 私有記憶，因 unified action 可能包含它，整個 action 都不可在 public surface 使用。Knowledge 不會授予 bucket、擴張 visibility，或繞過 owner 與 permission rules。\n\n本 family 是站內搜尋，不會上網。公開網路資訊應使用 Web family，公開網頁 query 走 `web.search`。零結果不代表 resource 不存在：可能 scopes 選得不完整、keywords 不相符，或 Agent 沒有權限。應說明此不確定性，並在適合時調整 scopes 或關鍵字再試。Registry schema、當下 permissions、snippets 與 runtime errors 一律高於本卡。\n",
  "aliases": [
    "站內搜尋",
    "在我的筆記找",
    "找之前的對話",
    "搜尋我的訊息",
    "全站搜尋",
    "in-product search",
    "find in my notes",
    "search my messages"
  ],
  "tags": [
    "search",
    "overview",
    "scopes",
    "permissions",
    "routing"
  ],
  "relatedActions": [
    "arinova.search.query"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/search/overview/"
}
---

`arinova.search.query` 在 Arinova 站內搜尋，wire contract 只有七個 buckets：`messages`、`notes`、`memo`、`kanban`、`conversations`、`users`、`memory`。每次呼叫都必須提供非空的 `scopes` array，沒有隱含「全部」，Agent 也不可自創 scope。只選需求實際涉及的 buckets，欄位與 limit 細節再依 live schema。`users` bucket 會以 escaped public display name 或 username 搜尋，在 failed-search rate limit 下回傳受限公開欄位與穩定 ID。

每個 bucket 都各自執行 domain permission checks，只回 Agent 有權讀取的 resources；result snippets 有長度上限。`memory` bucket 是 Agent 私有記憶，因 unified action 可能包含它，整個 action 都不可在 public surface 使用。Knowledge 不會授予 bucket、擴張 visibility，或繞過 owner 與 permission rules。

本 family 是站內搜尋，不會上網。公開網路資訊應使用 Web family，公開網頁 query 走 `web.search`。零結果不代表 resource 不存在：可能 scopes 選得不完整、keywords 不相符，或 Agent 沒有權限。應說明此不確定性，並在適合時調整 scopes 或關鍵字再試。Registry schema、當下 permissions、snippets 與 runtime errors 一律高於本卡。