はじめに
AstrBotはオープンソースのチャットボット開発フレームワークで、QQ、Telegram、WeChat、その他のメッセージングプラットフォームをサポートし、OpenAI、DeepSeek、Googleに簡単にアクセスできます。 ジェミニ AstrBotは、Large Language Model (LLM)のようなインテリジェントなチャットボットを開発するためのフレームワークです。AstrBotは、ユーザーがインテリジェントなチャットボットを素早く構築できるように設計されており、開発者や技術愛好家に適しています。AGPL-v3ライセンスを使用し、オープンなコードと活発なコミュニティを持っています。
機能一覧
- QQ、QQチャンネル、Telegram、WeChat(個人用および企業用WeChat)、Flybook、Nailなど、マルチプラットフォームのメッセージングアクセスをサポート。
- OpenAI、Google Gemini、DeepSeek、Claude、Ollamaなど、複数の大きな言語モデルを統合し、ローカルモデルをサポートする。
- 設定可能なパーソナリティを持つ複数の対話ラウンドを提供し、画像理解と音声テキストをサポートします(ウィスパーをベースにしています)。
- ボットの設定、ログの表示、プラグインの管理のためのビジュアル管理パネルが組み込まれています。
- プラグインの拡張もサポートされており、ユーザーはチェックインやコード実行などのカスタム機能を開発できる。
- ウェブ検索、自然言語によるToDoリスト、ドッキングなどのエージェント機能を提供 ダイファイ プラットフォーム
- キーワードフィルタリングや百度コンテンツ監査などのコンテンツセキュリティ管理を含む。
- WebUIは、ユーザーがWebページを通じて直接ロボットと会話できるように提供される。
ヘルプの使用
AstrBotのインストールと使用方法は明確で、公式ドキュメントには様々な展開方法が記載されています。以下、インストール手順と操作の主な特徴について詳しく説明する。
設置プロセス
AstrBotはソースコードデプロイメント、Dockerデプロイメント、Windowsワンクリックインストール、Pagodaパネルデプロイメントなどをサポートしています。ソースコードデプロイとDockerデプロイの例を示します。
ソースコードの展開
- 環境を整える
GitとPython 3.11+がインストールされていることを確認する。WindowsユーザーはPythonの公式ウェブサイトから、LinuxユーザーはPythonの公式ウェブサイトからPythonをダウンロードできる。sudo apt install python3
インストール。 - ダウンロードコード
ターミナルで実行:
git clone https://github.com/AstrBotDevs/AstrBot
cd AstrBot
またはGitHubからZIPファイルをダウンロードして解凍する。
- 依存関係のインストール
おすすめuv
道具だ:
pip install uv
uv run main.py
伝統的な方法でもいい:
pip install -r requirements.txt
python main.py
- トリガ手順
実行後、ターミナルには次のように管理パネルのアドレスが表示される。http://localhost:6185
.デフォルトアカウントを使用するastrbot
およびパスワードastrbot
ログイン
Dockerのデプロイメント
- Dockerのインストール
Dockerがインストールされ、利用可能であることを確認するdocker --version
チェックする。 - イメージを取り出して実行する
それをターミナルに入力する:
docker run -d -p 6185:6185 -v astrbot-data:/app/data soulter/astrbot:latest
-p 6185:6185
マッピングポート-v
コンフィギュレーションを保存するデータボリュームを作成する。
- アクセスパネル
ブラウザを開き、次のように入力する。http://localhost:6185
デフォルトのパスワードでログインしてください。
主な機能
ビッグ言語モデルの設定
- 管理パネルにログインし、プロバイダー設定をクリックします。
- モデルタイプを選択してください。
openai_chat_completion
. - APIキー(OpenAIなどのプラットフォームから取得)とアドレス(デフォルト)を入力します。
https://api.openai.com/v1
). - 特定のモデル(例
gpt-3.5-turbo
)、保存すれば有効になる。
マルチプラットフォームへのアクセス
- 管理パネルのMessaging PlatformsオプションからTelegramなどのプラットフォームを選択する。
- 必要な情報を入力する(例:BotFatherから入手したTelegramのBot Token)。
- 設定を保存すると、ボットは対応するプラットフォーム上のメッセージに応答できるようになります。例えば、Telegramの場合
/start
ロボットはこう答えるだろう。
プラグインの使用
- プラグイン(例:Telegram Adaptor)をダウンロードして
<AstrBot目录>/data/plugins
. - AstrBotを再起動すると、プラグインが自動的にロードされます。
- 管理パネルでプラグインを有効にし、メッセージレート制限の設定などのパラメータを設定します。
マルチモーダル機能
- 画像理解例:「この写真について説明してください」というプロンプトとともにボットに写真を送ると、ボットがそれを分析して返信します。
- 音声テキスト音声ファイルを送信するには、プロバイダー設定でウィスパーを有効にします。
エージェント機能
- ウェブ検索"天気予報を検索 "と送信すると、ボットが結果を返します。
- コード実行コードスニペット(Pythonなど)を送信するには、サンドボックス化されたコードエグゼキュータを有効にする必要があります。
ほら
- サーバーの展開には
localhost
をサーバーIPに変換する。 - Gewechatを使用してWeChatの個人番号にアクセスする場合は、ブロックを避けるために別のアカウントを使用することをお勧めします。
- Dockerのデプロイにはマッピングが必要
/var/run/docker.sock
そうでなければ、コード実行者は利用できない。 - 最初の実行は、設定ファイルを生成する
<AstrBot目录>/data/config.json
これは手動で編集できる。
以上の手順で、ユーザーは簡単にAstrBotを導入し、使用することができる。
アプリケーションシナリオ
- 個人アシスタント
リマインダーを設定し、メッセージをチェックし、AstrBotでTelegramをサポートする準備をしましょう。 - グループチャット管理
QQグループやFlybookでは、ロボットが自動的に質問に答え、チェックインを管理し、効率を向上させることができる。 - 学習ツール
生徒たちはAstrBotを使って数式を分析したり、音声メモを書き写したりして、学習を助けることができる。 - 開発テスト
開発者は、LLMダイアログの効果をテストしたり、新しいプラグイン拡張機能を開発したりできる。
品質保証
- すでにサポートされているプラットフォームは?
QQ(公式およびOneBot)、QQ Channel、Telegram、WeChat(個人および企業向けWeChat)、Flybook、Nailはすでにサポートされており、Discordなどは開発中だ。 - 新しいモデルを追加するには?
管理画面の "Providers "に追加する。 オーラマ ローカルアドレスとモデル名で十分です。 - スタートアップが失敗したら?
端末のログを確認してください。依存関係が欠けていたり、ポートが占有されている可能性があります。以下のことを確認してください。requirements.txt
インストールは完了した。 - プラグインはどのように開発されるのですか?
公式文書を参照<https://astrbot.app/dev/plugin.html>
にコードを入れる。data/plugins
再起動する。