用途:帮助在 Palantir Foundry 中为事件生产与消费选择受支持的集成路径。实时 Ontology 对象更新使用 OSDK 或 Object Set Watcher WebSocket 订阅;监控通知与出站集成使用其文档化的 Webhook 接口,不应臆造通用的 ontology.object.created 注册 API。
主要能力:TypeScript OSDK 订阅需兼容的生成式 OSDK/客户端,通过 .subscribe 接收对象集更新;直接 Object Set Watcher 订阅使用文档化 WebSocket 端点,并以 WebSocket 子协议格式编码的 bearer token 认证;订阅可能报告过期状态,需重新加载完整对象集;监控视图可通过 Data Connection 中配置的 Webhook 路由通知,这与 Ontology 对象订阅不同。
使用方式:先识别生产者、消费者、对象集或监控视图、支持的交付面、数据敏感度、延迟目标与恢复行为;确认 OSDK 版本或 WebSocket 契约,或监控所需的 Data Connection Webhook;阅读 references/official-docs.md 并验证目标注册功能访问权限;准备非生产对象集或监控视图及幂等消费者。定义有界对象过滤器或监控条件、返回属性/消息内容、认证、重连/退避与取消;实现幂等与持久对账,在 onOutOfDate、断连或交付缺口时重新加载权威状态。
适用场景:Ontology 对象集变更、监控通知或其他文档化 Foundry 集成。
限制:订阅不授权回写;Ontology 与数据所有者批准订阅对象/属性,安全所有者批准认证与出站目标,监控所有者批准通知路由。若请求的事件无文档化交付面,不要臆造,改用有预算的轮询、受支持的监控路由或联系 Palantir Support。Webhook 认证头不可假设,须检查实际 Data Connection 配置。