保存型ワークスペースでスコープ付きの bdk_… 認証情報を使い、コンテキストパック、学習済みフィールド、クエリテンプレート、MCP ツール、ガバナンス付きメモリを利用します。
開発者
Bundata は、API サーバーの /api/agent/v1 配下で 2 つの開発者向けインターフェース(原則読み取り専用、オプトインのメモリとギャップ報告を除く)を提供します。認証には 設定 → エージェントアクセス で発行するスコープ付きエージェント認証情報(bdk_…)を使用します。
開発者ガイド
- エージェントコンテキスト API: スコープ付き
bdk_…認証情報の作成、コンテキストセットへのバインド、トークン予算内での順位付け・引用付きコンテキストパック構築(POST /api/agent/v1/context-packsおよび/stream)、リプレイ検証、学習済みフィールドクエリ(list_fields、query_fields)、承認済み PostgreSQL クエリテンプレートの実行。 - ワークスペース MCP サーバー: ステートレスな Streamable HTTP 経由で TypeScript(
@modelcontextprotocol/sdk)や Python(mcp)クライアントをPOST /api/agent/v1/mcpに接続し、22 種類のスコープ付きツールと<untrusted-document-text-<nonce>>フェンスを扱う方法。 - ガバナンス付きエージェントメモリ: ワークスペースの owner が有効化したときに、エージェントが認証情報作成者向けに PII マスク済み・出典再確認付きのメモを保存・想起する方法(
remember_memory、recall_memories、list_memories、forget_memory)。
境界とサポート
公開 SDK パッケージは提供していません(未確認のパッケージをインストールしないでください)。エージェントエンドポイントはブラウザからのリクエスト(AGENT_BROWSER_REQUEST_REFUSED)および非保持ワークスペース(403 NON_RETAINING_WORKSPACE)を拒否します。完全な契約は API リファレンス、制限、エラーコード を参照し、問題が発生した場合はワークスペース ID とリクエスト ID を添えて contact@bundata.com にメールしてください。