保存型ワークスペースでスコープ付きの 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 にメールしてください。