OpenGov OG Assist：把业务页面、工具执行与人的决定接在一起

在业务页面里问这些收费代码是什么意思，助手需要取得当前产品的真实配置，知道哪些页面对象可以操作，并在行动前把控制交回应用。OpenGov 的 OG Assist 公开演讲展示了这些能力；有用的工程经验，是把共享运行层与产品团队提供的工具分开建设。

查询、高亮、审批、表单、PDF 是不同演示片段，不能串成已公开的政府业务交易。本页重组原始幻灯片与带时间戳转录支持的机制；大会网页另附的解释性代码不当 OpenGov 生产源码。演讲与转录

收费答案来自业务套件

Utility Billing 演示中，用户从原页面打开侧栏询问 rate codes。界面显示工具查询，返回 Rate Code、Type、Dependent Usage Group 三列，区分服务收费、一次性收费及用量组关联。这是读取配置后解释，不是模型凭通用知识猜机构规则。页面的演示机构和数据也不是政府客户业绩。（2:22–3:27）

另一个片段解释当前页面并突出 View Accounts 入口，说明前端也是工具作用的对象。演讲未公开页面信息如何抽取、组件标识如何绑定，也未证明任意 DOM 操作或越权。迁移时，哪些组件允许引用和高亮，应成为前端能力契约。（3:27–4:35）

共享循环连接不同执行目的地

中央团队维护 Agent 循环，产品团队贡献领域工具与技能。调用可能读取后端、作用前端，或进入隔离环境执行代码；三者不是固定流水线。统一聊天入口也不意味着所有产品拥有同一组操作与权限。（4:35–8:48、16:19–17:25）

团队最初使用 LangGraph，随团队和用例扩展改用 Effect-native 循环，以控制执行、并发、资源和追踪。演讲强调控制粒度与可维护性，没有框架速度、成本或准确率对照。语言模型通过依赖注入传入，便于替换；能替换不等于已有自动路由，换模型后的工具行为仍需验收。（5:47–7:41）

工具定义与实际处理是两层

幻灯片引用 Effect 的 GetDadJoke：Tool.make 定义名称、用途、参数和结果，Toolkit.make 汇集能力，再交给模型。它是 Effect v3 时期实验性 AI 接口的框架示例，不保证与当前 API 可直接互换；更不是收费 API，不能改名后当恢复出来的生产契约。（16:19–17:25）

Effect 文档再用 toLayer 提供实际 handler，从应用服务取得执行依赖。模型选择工具和参数，访问服务的逻辑仍由应用提供；success/failure 描述预期契约，不保证网络、权限或实现永不失败。工具定义与 handler

对跨产品团队，这意味着共享层维护循环和调用协议，产品团队负责领域参数、服务逻辑与错误语义。演讲披露工具和技能集中同一仓库，可由工程师扩展；完整仓库、业务 schema、生产 Prompt 和逐工具重试策略未公布，不能靠框架样例补齐。

前后端采用 A2A 的 AgentCard 等规范形成共同契约，用来统一路由、模型和 schema。名称叫 Agent-to-Agent 不证明内部采用多代理协作，也不证明所有接口都是 MCP；提到 A2UI 不能反推动态表单具体实现。（7:41–9:16）

人的决定改变程序是否继续

审批片段显示 Accept、Reject 和查看参数。演讲明确说，需要批准的工具调用会确定性中断循环，等待人决定；工具请求本身不授权执行。这比提示词中的重要操作请确认更明确。（10:31–11:13）

资料未交代哪些操作触发审批、批准是否持久化、过期如何恢复，或参数变化后是否重批。能借鉴的是应用控制流中的门禁，不能声称完整多级财政审批或双人复核。查询、审批、文件生成也不能画成同一交易。

动态表单是另一类交互：用户要求长文并先选主题，助手使用已注册的表单在运行时给选项，等待输入；它不是动作批准。（14:11–14:53）

文件演示在按需创建、用后销毁的隔离环境中运行代码，产出可下载的大会问候 PDF。它说明能交付文件，不是政府正式公文的生产证据；沙箱供应商、隔离级别、客户数据授权没有披露。（11:13–12:27）

摘要保留线索，业务事实仍需重查

长历史导致上下文窗口与输入过载，团队采用滚动摘要加近期消息：摘要携带较早讨论线索，近期原文保留当下语境。N、N−5、N−10 是演讲示意，不是生产参数；recall 针对摘要保留内容，不保证原对话细节全可恢复，也没有公开跨会话长期记忆库。（12:27–14:11）

压缩能减少输入，却可能丢限定。迁移时，余额、状态、权限等动态事实应由业务工具重读，不因摘要记得旧值就执行。这是接入建议，不是 OpenGov 已公开的校验规则。

把慢与错追到可修复的位置

产品收集赞/踩及原因，辅以电话邮件；CI 用实际模型完成结果检查预期工具和任务行为。它同时观察线上体验与可重复检查，但没有公开准确率、通过分母或客户收益，也未证明每条反馈自动进入评测集。（9:16–10:31）

追踪用 span 表示工作段，组合为 trace，观察耗时和跨服务故障。Effect 文档用 withSpan 与追踪后端说明埋点；选框架不等于所有业务函数自然完整可观测。演讲中的支付/派送时间线明确来自 Effect 团队，不能当 OpenGov 客户性能数据。追踪机制（14:53–16:19）

要把助手嵌进自己的产品，先选权限边界清楚的一项读取和一项受控操作。沿真实页面核对：上下文是否指向正确对象，结果能否回到页面，拒绝批准后是否确实不执行，异常能否定位。表单选择、动作批准和文件交付分别定义完成条件，才能知道助手帮助用户完成了什么。