SDK 概要

SDK が提供するもの​

• API アクセスの簡素化: REST リクエストをラップし、認証とエンドポイント設定を一箇所にまとめます
• SSE ストリームの処理: Server-Sent Events を自動で処理し、ボットの応答を生成されたそばから受け取れます
• Channel の管理: セッションの永続化が組み込まれており、複数ターンの対話に対応します
• React コンポーネント: @asgard-js/react がすぐ使えるチャット UI とフックを同梱しています

インストール​

JavaScript SDK​

あらゆる JavaScript 環境（Node.js、ブラウザ、フレームワーク非依存）向けです。

npm install @asgard-js/core

React SDK​

React アプリケーション向けで、UI コンポーネントとフックを含みます。

npm install @asgard-js/react

@asgard-js/react は @asgard-js/core を peer dependency とするため、両方をインストールしてください。

クイックスタート​

次の例は @asgard-js/core の低レベル API でメッセージを送り、ストリーミング応答を受け取るものです。

import { AsgardServiceClient, Channel, Conversation } from '@asgard-js/core';
 
const client = new AsgardServiceClient({
  botProviderEndpoint:
    'https://api.asgard-ai.com/ns/{namespace}/bot-provider/{botProviderId}',
});
 
const conversation = new Conversation({ messages: new Map() });
 
const channel = await Channel.reset({
  client,
  customChannelId: 'channel-123',
  conversation,
  statesObserver: (states) => {
    console.log('Messages:', Array.from(states.conversation.messages.values()));
  },
});
 
await channel.sendMessage({ text: 'こんにちは、自己紹介をお願いします' });

React を使う場合は <Chatbot> コンポーネントから始めるのが簡単です。

import { Chatbot } from '@asgard-js/react';
import '@asgard-js/react/style';
 
export default function App() {
  return (
    <div style={{ height: '100vh' }}>
      <Chatbot
        title="マイ AI アシスタント"
        customChannelId="user-123"
        config={{
          botProviderEndpoint:
            'https://api.asgard-ai.com/ns/{namespace}/bot-provider/{botProviderId}',
        }}
      />
    </div>
  );
}

SDK と REST API 直接呼び出しの比較​

関連ドキュメント​

• JavaScript SDK リファレンス — @asgard-js/core の全 API
• React SDK リファレンス — @asgard-js/react のコンポーネントとフック
• SDK Demo — SDK の各機能を実際に動かせるサンプル（メッセージテンプレート、テーマ、認証、headless での利用など）
• SDK Demo — 統合の全体像 — ボットの作成からフロントエンド公開までの一連の流れ

GitHub​

ソースコードと最新版: asgard-ai-platform/asgard-js-sdk