SDK

Beeuni Computer をあなたの製品の Agent バックエンドとして活用します。

@beeuni/sdk でプロジェクトを管理し、エージェントのセッションを実行し、ツールを接続できます。

インストール

npm install @beeuni/sdk

クライアントの作成

Account → Tokens で API キーを作成します。サーバー用の API キーはサーバーに保存してください。

import { createBeeuni } from '@beeuni/sdk';

const beeuni = createBeeuni({
  backendUrl: 'https://api.beeuni.ai/v1',
  getToken: async () => process.env.BEEUNI_API_KEY ?? null,
});

const projects = await beeuni.projects.list();

SDK はリクエストごとに getToken を呼び出します。トークンの保存と更新はあなたのアプリが管理します。認証を参照してください。

Connector の呼び出し

プロジェクトで利用できるツールを検索し、入力スキーマを確認します。接続の認証情報は Beeuni が管理します。

BEEUNI_PROJECT_ID に、API キーでアクセスできる既存のプロジェクト ID を設定します。

const projectId = process.env.BEEUNI_PROJECT_ID!;
const connectors = beeuni.project(projectId).connectors;

console.log(await connectors.catalog());
console.log(await connectors.search('search email'));

toolName を検索結果のツール名に置き換え、入力スキーマに従って args を設定します。呼び出しには認証済みの接続とツールの使用権限が必要です。

const toolName = 'your_connector.your_action';
console.log(await connectors.describe(toolName));

const args = {};
const result = await connectors.call(toolName, args);
console.log(result);

最初のセッションを開始

const created = await beeuni.project(projectId).sessions.create({
  name: 'My first SDK session',
});
const session = beeuni.session(projectId, created.session_id);

await session.ensureReady();
await session.send('Describe your capabilities in one paragraph.');

ensureReady() はセッションを開始または再開し、準備が整うまで待機します。上書き指定がなければ、send() はプロジェクトに設定されたモデルと Agent を使用します。セッションはクレジットを消費します。

イベントの受信と応答の読み取りは完全なサンプルを参照してください。React の画面には React hooks を使用します。

SDK

インストール

クライアントの作成

Connector の呼び出し

最初のセッションを開始

ガイド