官方包 · 实时功能组件

AI 代理的人工审批

代理要执行需要有人同意的工具时,这个调用会在实时收件箱里等待。审核者可以批准、修改或拒绝,也能看到还有谁在看,代理会从停下的地方继续。

  • 提供 Vercel AI SDK、Mastra 和 LangGraph 的服务端辅助函数,以及支持 LangGraph 和 FastAPI 的 Python 包。
  • React 和 Vue 的收件箱组件,支持七种语言、亮色和暗色。
  • 和 Filament AI approvals 及 MCP 服务器的 request_approval 工具共用同一套协议,一个收件箱就能显示所有来源的请求。

登录后,示例代码会自动填入您的集群主机。 登录

  1. 安装

    npm install @hibira-io/approvals pusher pusher-js
  2. 配置

    import Pusher from 'pusher';
    import { createApprovals } from '@hibira-io/approvals';
    
    const pusher = new Pusher({
      appId: process.env.HIBIRA_APP_ID,
      key: process.env.HIBIRA_KEY,
      secret: process.env.HIBIRA_SECRET,
      host: 'ws.hibira.io',
      useTLS: true,
    });
    
    export const approvals = createApprovals({
      pusher,
      scope: 'support',
      resume: async (request) => continueAgent(request), // give the agent its answers
    });
  3. 使用

    import { ApprovalInbox, createApprovalsClient } from '@hibira-io/approvals/react';
    import '@hibira-io/approvals/styles.css';
    
    const client = createApprovalsClient({ endpoint: '/api/approvals', pusher, scope: 'support' });
    
    export function ApprovalsPage({ me }) {
      return <ApprovalInbox client={client} me={me.id} />;
    }

开始之前

  • 应用密钥只会在创建应用或轮换密钥时显示一次。请只放在服务器上,不要放进浏览器或游戏的构建包。
  • approvals.handler() 提供收件箱需要的 route 和频道授权。决定会从收件箱送到你的后端,不会走 client event。
  • 请求默认存在内存中。生产环境请传入一个基于你自己数据库的 store。

请使用控制台中应用的 Key;Secret 只放在你的服务器上。频道、事件与授权端点的用法与 Pusher 完全相同。 免费创建账号 →