Gói chính thức · Thành phần thời gian thực

Phê duyệt của con người cho AI agent

Khi agent muốn chạy một công cụ cần người đồng ý, lời gọi sẽ chờ trong hộp thư trực tiếp. Người duyệt có thể phê duyệt, sửa hoặc từ chối, thấy ai khác đang xem, và agent tiếp tục từ chỗ đã dừng.

@hibira-io/approvalsnpm ↗GitHub ↗PyPI ↗

• Hàm hỗ trợ phía máy chủ cho Vercel AI SDK, Mastra và LangGraph, cùng gói Python cho LangGraph và FastAPI.
• Component hộp thư cho React và Vue, bảy ngôn ngữ, giao diện sáng và tối.
• Dùng chung một giao thức với Filament AI approvals và công cụ request_approval của máy chủ MCP, nên một hộp thư hiển thị được yêu cầu từ tất cả.

Đăng nhập để xem các đoạn mã này với host cụm của riêng bạn. Đăng nhập

1. Cài đặt

   npm install @hibira-io/approvals pusher pusher-js

2. Thiết lập

   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. Sử dụng

   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} />;
   }

Trước khi bắt đầu

• Secret của ứng dụng chỉ hiện một lần, khi bạn tạo ứng dụng hoặc xoay vòng secret. Hãy giữ nó trên máy chủ, không bao giờ đưa vào trình duyệt hay bản build game.
• approvals.handler() phục vụ các route của hộp thư và xác thực kênh. Quyết định đi từ hộp thư tới backend của bạn, không qua client event.
• Mặc định yêu cầu được lưu trong bộ nhớ. Khi chạy thật, hãy truyền một store dùng cơ sở dữ liệu của bạn.

Dùng app key từ bảng điều khiển; secret chỉ để trên máy chủ của bạn. Kênh, sự kiện và endpoint xác thực hoạt động y như với Pusher. Tạo tài khoản miễn phí →