はじめに
クイックスタート
5分以内に動作するチャットウィジェットをサイトに導入しましょう。
このガイドでは、5分でチャットウィジェットをサイトに公開します。
1. ワークスペースを作成する
cs.askais.com/signup でサインアップします。サブドメイン (例: acme.cs.askais.com)を選び、OWNER ユーザーを作成します。
2. 受信トレイを作成する
管理画面で Settings → Inboxes → New inbox に移動します。チャネル WEBを選び、"Website chat" のような名前を付けます。 appId と secretKey が発行されます。
シークレットキーは必ず保存してください —— 一度しか表示されません。後でローテーションできます。
3. ウィジェットを埋め込む
このスニペットをサイトの </body> の直前に貼り付けます:
<script src="https://cs.askais.com/widget.js"
data-app-id="YOUR_APP_ID"
data-base-url="https://cs.askais.com"></script>4. AI エージェントを設定する
管理画面で AI Agent に移動します。2 つの選択肢があります:
- プラットフォーム提供のキーを使う(プランの AI クォータに依存します)
- BYOK —— 自分の OpenAI / Anthropic / DuckLLM キーを追加する(保存時に暗号化されます)
5.(任意)ナレッジを追加する
Knowledge でドキュメントをアップロードします。worker がそれをチャンク化し、 埋め込み、インデックス化することで、AI の返信が実際のコンテンツに基づいたものになります。
6. テストする
サイトを開き、チャットバブルをクリックして質問を送信します。最初のメッセージで 管理画面の受信トレイに会話が作成され、AI の返信が token ごとにストリーミングで返ってきます。
完了です。次は: ウィジェットをカスタマイズする、または webhook に接続します。