チャットボット

このガイドでは、Agentベースのチャットボットの例について包括的に解説します。さまざまなモードでチャットボットを実行する方法、さまざまなAIモデルプロバイダーに接続する方法、そしてAIGNEのオブザーバビリティツールを使用してその実行をデバッグする方法を学びます。この例は、ローカルに何もインストールすることなくすぐに始められるように設計されています。

概要

この例では、AIGNEフレームワークを使用して、シンプルかつ強力なAgentベースのチャットボットを作成および実行する方法を示します。主に2つの動作モードをサポートしています：

チャットボットは、さまざまなAIモデルを使用するように設定でき、コマンドラインから直接、またはパイプラインを通じて入力を受け入れることができます。

前提条件

この例を実行する前に、システムに以下がインストールされていることを確認してください：

クイックスタート

リポジトリをクローンしたり、依存関係をローカルにインストールしたりすることなく、npxを使用してこの例を直接実行できます。

例の実行

ターミナルで以下のコマンドを実行してチャットボットを起動します。

デフォルトのワンショットモードで実行：

npx command

npx -y @aigne/example-chat-bot

--interactiveフラグを使用してインタラクティブなチャットモードで実行：

npx command

npx -y @aigne/example-chat-bot --interactive

パイプライン入力を使用してプロンプトを直接提供：

npx command

echo "Tell me about AIGNE Framework" | npx -y @aigne/example-chat-bot

AIモデルへの接続

この例を初めて実行すると、APIキーが設定されていないため、AIモデルサービスに接続するように求められます。次の図は、利用可能な接続オプションを示しています：

direction: down

Chatbot-Example: {
  label: "チャットボットの例\n(@aigne/example-chat-bot)"
  shape: rectangle
}

Connection-Options: {
  label: "接続オプション"
  shape: rectangle
  style: {
    stroke-dash: 4
  }

  Official-AIGNE-Hub: {
    label: "1. 公式AIGNE Hub\n(推奨)"
    icon: "https://www.arcblock.io/image-bin/uploads/89a24f04c34eca94f26c9dd30aec44fc.png"
  }

  Self-Hosted-Hub: {
    label: "2. セルフホストAIGNE Hub"
    icon: "https://www.arcblock.io/image-bin/uploads/89a24f04c34eca94f26c9dd30aec44fc.png"
  }

  Third-Party-Provider: {
    label: "3. サードパーティプロバイダー\n(例: OpenAI)"
    shape: rectangle
  }
}

Blocklet-Store: {
  label: "Blocklet Store"
  icon: "https://store.blocklet.dev/assets/z8ia29UsENBg6tLZUKi2HABj38Cw1LmHZocbQ/logo.png"
}

Chatbot-Example -> Connection-Options: "AIモデルへの接続をユーザーに促す"
Connection-Options.Self-Hosted-Hub -> Blocklet-Store: "ここからインストール"

続行するにはいくつかのオプションがあります：

1. 公式AIGNE Hubに接続する（推奨）

これが最も簡単な開始方法です。

2. セルフホストのAIGNE Hubに接続する

独自のAIGNE Hubインスタンスを実行している場合：

セルフホストのAIGNE Hubをセットアップする必要がある場合は、Blocklet Storeからインストールできます。

3. サードパーティのモデルプロバイダー経由で接続する

適切な環境変数を設定することで、OpenAIなどのサードパーティAIモデルプロバイダーに直接接続することもできます。たとえば、OpenAIを使用するには、次のようにAPIキーを設定します：

OpenAI APIキーを設定

export OPENAI_API_KEY="YOUR_OPENAI_API_KEY"

環境変数を設定した後、再度この例を実行してください。サポートされているプロバイダーとその必要な環境変数のリストについては、例の設定ファイルを参照してください。

ローカルでのインストールと使用

開発目的で、リポジトリをクローンしてローカルで例を実行したい場合があります。

1. AIGNE CLIのインストール

まず、AIGNEコマンドラインインターフェース（CLI）をグローバルにインストールします。

AIGNE CLIをインストール

npm install -g @aigne/cli

2. リポジトリのクローン

aigne-frameworkリポジトリをクローンし、chat-botの例のディレクトリに移動します。

リポジトリをクローン

git clone https://github.com/AIGNE-io/aigne-framework
cd aigne-framework/examples/chat-bot

3. ローカルで例を実行

pnpm startコマンドを使用してチャットボットを実行します。

デフォルトのワンショットモードで実行：

pnpm command

pnpm start

インタラクティブなチャットモードで実行：

pnpm command

pnpm start --interactive

パイプライン入力を使用：

pnpm command

echo "Tell me about AIGNE Framework" | pnpm start

コマンドラインオプション

チャットボットスクリプトは、その動作をカスタマイズするためにいくつかのコマンドライン引数を受け入れます。

AIGNE Observeによるデバッグ

AIGNEには、Agentの実行をデバッグおよび分析するための強力なローカルオブザーバビリティツールが含まれています。aigne observeコマンドは、実行トレースを検査するためのユーザーインターフェースを提供するローカルWebサーバーを起動します。

まず、ターミナルでオブザベーションサーバーを起動します：

aigne observe

aigne observe

チャットボットを実行した後、提供されたURL（通常はhttp://localhost:7893）をブラウザで開くと、最近のAgent実行のリストを表示できます。このインターフェースでは、入力、出力、モデル呼び出し、パフォーマンスメトリクスなど、各実行の詳細情報を検査でき、デバッグや最適化に非常に役立ちます。

まとめ

この例は、AIGNEフレームワークを使用してAgentベースのチャットボットを構築するための実践的な基盤を提供します。この例の実行方法、さまざまなAIモデルへの接続方法、デバッグのための組み込みオブザーバビリティツールの活用方法を学びました。

より高度なトピックや例については、以下のドキュメントが役立つかもしれません：