Bounded Observe 是 Bounded 的 Action Boundaries 能力,用来观察并约束应用或智能体发起的外部动作,例如 ctx.ai 花费、ctx.services 工具调用以及 agent egress。它与数据、后端、UI 边界并列,思路是先观察、再一键执行。
动作边界有三种状态,信任级别不同:Watching 下所有被识别的外部动作进入应用的 Feed,按执行者归因,不改行为,仅是上报,不代表受保护;Suggested 是基于真实事件生成的基线卡片,每张卡会给出证据(观察窗口与事件数),属于提议而非保护;Enforced 通过 Promote 把建议变成生效边界,每个匹配动作得到确定性裁决——allowed(允许)、declined(附带被跨越边界名称的错误)、waiting for approval(签名审批链接,批准后动作触发)。
使用方式按任务分:观察智能体调用与自托管 shim 接线,看 docs/observing-agent-actions.md;阅读建议边界卡、判断证据并了解 Promote,看 docs/suggested-boundaries.md;查询与过滤持久化的观察与决策日志,看 docs/querying-observe-data.md。涉及 @bounded-sh/observe、--require @bounded-sh/observe/register、BOUNDED_SENSOR_TOKEN、BOUNDED_INGEST_BASE、obs1. token、runAs、middleware()、unattributed 时读第一份;涉及 @bounded-sh/observe/edge 等边缘运行时读第一份;涉及 bounded-ai-gateway 与代理观测同样读第一份;涉及 Feed、Actors、Coverage、建议卡、allowed/declined、GET /dash-api/query 等分别读对应文档。
限制与注意:Watching 是 fail-open,只上报不保护,发射器失效会在 Coverage 标签页体现,安静前先查那里;declined 表示动作会跨越某个已命名 Enforced 边界,应调整边界或动作而非反复重试。自托管后端下,escorted 检查通过构建者安装的 shim 在进程内运行,移除 shim 即移除检查,它防的是智能体失误,而非有人故意拆除。免费样本含 Watching 与 Suggested(每日限量、保留期短),Enforced(escorted 裁决、审批、更长保留)属既有 Pro 层,无单独 SKU;企业托管为另一产品面。未公开的定价或未来能力不在资料内。