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

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

## インストール

```bash
npm install @beeuni/sdk
```

## クライアントの作成

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

```ts
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` を呼び出します。トークンの保存と更新はあなたのアプリが管理します。[認証](/docs/ja/sdk/auth) を参照してください。

## Connector の呼び出し

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

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

```ts
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` を設定します。呼び出しには認証済みの接続とツールの使用権限が必要です。

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

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

## 最初のセッションを開始

```ts
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 を使用します。セッションはクレジットを消費します。

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

## ガイド

- [Beeuni でサインイン](/docs/ja/sdk/sign-in)
- [完全なサンプル](/docs/ja/sdk/example)
- [認証](/docs/ja/sdk/auth)
- [セッション](/docs/ja/sdk/sessions)
- [Apps](/docs/ja/sdk/apps)
- [React フック](/docs/ja/sdk/react)
- [API リファレンス](/docs/ja/sdk/reference)