はじめに
OAK（Open Agent Kit）は、開発者がAIインテリジェンスを素早く構築、カスタマイズ、デプロイできるように支援するオープンソースツールです。OAKは、OpenAI、Google、Anthropicのような大規模言語モデル（LLM）に接続することができ、プラグインによる機能追加もサポートしています。モジュール構造、直感的なAPI、使いやすいインターフェイスコンポーネントを提供し、開発者がアイデアから本番環境に素早く移行できるようにします。インテリジェント・アシスタントの構築でも、AIを活用した顧客サービスの開発でも、OAKは柔軟性と拡張性を提供します。このサイトは開発者コミュニティによって運営されており、コードは公開され、ユーザーは自由に変更できるため、あらゆる規模のプロジェクトに適しています。
機能一覧
- 任意のLLM接続をサポート：OpenAI、Google、Anthropic、その他のモデルと互換性があり、セルフホストモデルもサポート。
- プラグイン・エクステンション：データ処理やリアルタイム検索など、プラグインによる機能追加。
- モジュール設計：AI機能を簡単にカスタマイズできるよう、調整可能なコンポーネントを提供。
- ワンクリックラン：複雑な設定をすることなく、コマンドで素早くネイティブアプリを起動。
- インターフェイスコンポーネント：ウェブサイトやアプリケーションに組み込むことができる組み込みのチャットインターフェイス。
- オープンソースで透明性が高い：コードはGitHubで公開されており、ユーザーによる修正や貢献が可能。
- データベースサポート：PostgreSQLにオプションで設定し、データをより便利に保存します。
- コミュニティ主導型：Discordを通じてサポートを受けたり、経験を共有することができます。
ヘルプの使用
OAKはシンプルでわかりやすく、迅速なスタートアップにも、綿密な開発サポートにも適しています。以下は詳しいインストール方法と使用方法です。
基本的なインストール手順
コードを変更したりプラグインを開発したりせずにOAKを直接実行したい場合は、以下の手順に従ってください：
- アプリケーションを起動する
ターミナルを開き、コマンドを入力する：
npx @open-agent-kit/cli run docker
これで自動的にOAKがダウンロードされ、起動する。
- 構成モデル
コマンドラインは、モデル（例えばOpenAIのGPT-4o）を選択し、APIキーを入力するよう促します。プロンプトに従ってキーを入力します。OPENAI_API_KEY=你的密钥と入力する。 - アプリケーションへのアクセス
起動に成功したら、ブラウザーを開き、次のように入力する：
http://localhost:3000
OAKのチャット画面が表示されます。
- 試運転
インターフェイスに「今日は何曜日ですか」と入力し、正しい答えが返ってくればインストールは成功です。
高度なインストールプロセス
デフォルトモデルを変更したい場合、プラグインを追加したい場合、新しい機能を開発したい場合は、以下の手順に従ってください：
プロジェクトを作成する
- プロジェクトの作成
それをターミナルに入力する：
npx @open-agent-kit/cli create project
これにより、デフォルト設定のプロジェクトフォルダーが作成されます。
- カタログへのアクセス
輸入cd 项目名プロジェクト・カタログに入る。
データベースのセットアップ（オプション）
- PostgreSQLの実行
Dockerでデータベースを起動し、入力する：
docker run --name oak-db
-e POSTGRES_USER=你的用户名
-e POSTGRES_PASSWORD=你的密码
-e POSTGRES_DB=oak
-p 5432:5432 -d pgvector/pgvector:pg17
相互互換性你的用户名歌で応える你的密码.
- コネクションの設定
プロジェクトの.env.exampleというのも.envファイルを編集し、データベース情報を記入する：
DATABASE_URL=postgresql://你的用户名:你的密码@localhost:5432/oak?schema=public
設定環境
- APIキーの取得
- OpenAI: アクセスOpenAI公式サイトキーを作成する。
- グーグル：参考ジェミニ・ドキュメンテーション.
- Anthropic: ビュー人類学的ドキュメンテーション.
- XAI：参照XAIドキュメント.
- アプリケーションキーの生成
インタビューhttps://api.open-agent-kit.com/generate-secret.html生成するAPP_SECRET例えば、こうだ：
APP_SECRET=生成的32位密钥
- 環境変数の設定
ある.envキーやその他の設定を記入する：
APP_URL=http://localhost:5173
OPENAI_API_KEY=你的密钥
APP_SECRET=你的应用密钥
地域開発
- 依存関係のインストール
インプット：
npm install
- 運用移行
データベースを使用する場合は、実行する：
npm run generate
npm run migrate:deploy
- アプリケーションを起動する
インプット：
npm run dev
インタビューhttp://localhost:5173管理インターフェイスに入る。
主な機能
コネクティングLLM
- インターフェースの「設定」をクリックし、モデル（例：Google Gemini）を選択します。
- APIキーを入力し、保存します。
- チャットボックスに「1+1は何回になりますか」など、質問を入力してテストする。
プラグインの追加
- のプロジェクトフォルダーにある
pluginsディレクトリにプラグインコードを追加します。(さんぷ). - うごきだす
npm run buildパッキング。 - アプリを再起動すると、プラグインが自動的に有効になります。
インターフェイスのカスタマイズ
- 管理インターフェイスで、色とフォントを調整します。
- のコピーを取る。
<iframe>あなたのウェブサイトに埋め込むためのコード。
注目の機能操作
モジュール開発
- OAKのモジュラー設計により、チャットロジックの変更など、機能を個別に微調整することができます。
- コードから探す
src/modules必要に応じて修正する。
クラウド展開
- Vercelを使ったデプロイ：ターミナルで次のようにタイプする。
vercel deployプロンプトに従ってください。 - デプロイ後に返されたURLにアクセスする。
これらのステップを踏むことで、OAKは設置から使用まで明確で操作性の高いものとなる。詳しくは公文書.
アプリケーションシナリオ
- インテリジェントアシスタント
ユーザーはOAKを使ってパーソナル・アシスタントを構築し、LLMに接続しているときに質問に答えたり、タスクを処理したりすることができる。 - 顧客サービス
企業はOAKをウェブサイトに組み込むことで、一般的な問い合わせへの対応を自動化し、効率を向上させることができる。 - 教育支援
教師はOAKを使って、生徒が質問を入力するとシステムが答えを返す質問回答ツールを作成する。 - データ分析
ビジネスデータを分析し、レポートを作成するためのデベロッパー＋データプラグイン。
品質保証
- OAKの対応機種は？
OpenAI、Google、Anthropicなど主流のLLMをサポートし、自作モデルもサポートする。 - プログラミングの知識が必要ですか？
基本的な使い方は不要で、インターフェイスを設定するだけでよい。プラグインの開発やコードの変更にはJavaScriptベースが必要です。 - 地元で運営するにはコストがかかりますか？
クラウドデプロイメントやAPIコールのみ有料。 - OAKをアップデートするには？
GitHubから最新のコードを取得し、インストール・コマンドを再実行するだけだ。
日本語 
简体中文 
English 
Deutsch 
Português do Brasil