はじめに
Potpie AIは、カスタマイズされたAIエンジニアリング・アシスタントを開発者に提供することに特化したオープンソースのプラットフォームである。AIエージェントがコードベースのナレッジグラフを構築することで、コード構造とロジックを深く理解し、デバッグ、テスト、コード生成などのタスクを自動化します。ユーザーは簡単なプロンプトで専用のエージェントを素早く作成し、既存の開発プロセスに組み込むことができる。このプラットフォームは複数のプログラミング言語をサポートしており、個人開発者にも企業チームにも適しています。Potpie AIは、VS CodeプラグインとAPIインターフェイスを提供しており、簡単に操作することができます。オープンソースであるため、ユーザは自由に探索し、拡張することができ、活発なコミュニティは効率的な開発を追求するプログラマに適しています。
機能一覧
- コードベース知識グラフコードベースを自動的に分析し、ナレッジグラフを生成し、関数呼び出しや依存関係などの複雑なロジックをキャプチャします。
- カスタムAIエージェント簡単なプロンプトワードで特定のエンジニアリングタスクを処理する専用のAIエージェントを作成します。
- オートメーション・デバッギングスタックトレースを分析し、問題の根本原因を素早く突き止め、解決策を提供する。
- テストケースの生成エッジシナリオと主要なプロセスをカバーする単体テストと統合テストのコードを作成する。
- コード・レビューコードの変更を分析し、影響を受けるAPIを特定し、最適化の提案を行う。
- ローレベル設計新機能の詳細な実装計画と設計書を作成する。
- コード生成必要に応じて新しいコードを生成したり、既存のコードを最適化する。
- 初心者ガイドQ&Aエージェントを通じて、新しい開発者がコードベースに素早く慣れることができるようにします。
- マルチモデル対応OpenAI、Gemini、Claudeなどの大型モデルをサポートし、柔軟な切り替えが可能。
- VSコードの統合プラグインを経由して、エディターで直接AIエージェントを呼び出します。
ヘルプの使用
インストールとセットアップ
Potpie AIはオープンソース版とホスティング版の両方があり、様々なニーズに対応できます。以下は、オープンソース版を使用するための詳細な手順です:
- 公式ウェブサイトを見るオープン
https://potpie.ai/
Get Started "ボタンをクリックしてください。 - コードベースのクローンGitHubリポジトリより
https://github.com/potpie-ai/potpie
ソースコードをダウンロードする。以下のコマンドを実行する:git clone https://github.com/potpie-ai/potpie.git
- 依存関係のインストールプロジェクトディレクトリに移動し、必要な依存関係(Python環境サポート)をインストールします。実行します:
cd potpie pip install -r requirements.txt
- 設定環境ドキュメントに従ってAPIキーを設定します。編集
config.yaml
ファイルにキーを記入する:llm: provider: openai api_key: your-api-key
- VS CodeプラグインのインストールVS Code Marketplaceで "Potpie AI "を検索し、インストールをクリックします。プラグインのアドレス
marketplace.visualstudio.com/items?itemName=PotpieAI
. - サービス開始以下のコマンドでローカルサービスを実行する:
python app.py
サービスが開始されると、VS Codeプラグインは自動的にローカルエージェントに接続します。
主要機能の使用
カスタムAIエージェントの作成
- VS Codeを開き、Potpie AIプラグインパネルに行く。
- Create Agent "をクリックし、プロンプトを入力します。例えば
Create an agent to analyze my Python codebase and generate unit tests for all functions.
- プラグインは自動的にコードベースを解析し、ナレッジマップを生成し、エージェントをデプロイする。
- 例えば "Generate tests for utils.py" のようなタスクをプラグインインタフェースに入力すると、エージェントはテストコードを返します。
オートメーション・デバッギング
- VS Codeでエラー・レポート・ファイルを開き、スタック・トレースをコピーする。
- Potpieプラグインの "Debugging Agent "を選択し、スタックトレースを貼り付ける。
- エージェントはエラーを分析し、可能性のある原因と修正手順をリストアップします。例
Error: NullPointerException in main.py:45 Suggestion: Check if variable 'user' is initialized before calling user.getId().
テストケースの生成
- ユニットテストエージェント」または「統合テストエージェント」を選択します。
- 例えば、"Generate integration tests for auth module "のように、対象となるファイルや関数を指定します。
- エージェントは、エッジシナリオと主要なフローを含むテストコードを、pytestやその他のフレームワークに準拠した形式で生成する:
def test_auth_login(): assert login("user", "pass") == True
コードレビューと最適化
- プラグインの「Code Changes Agent」を選択します。
- コードの変更をコミットする(Gitのコミットなど)。
- エージェントは変更を分析し、影響を受けるAPIやモジュールを特定し、最適化を提案します。例
Change in api.py may break downstream service. Suggest adding fallback logic.
初心者ガイド
- コードベースQ&Aエージェント」を選択します。
- このプロジェクトはどのようにセットアップするのか」「process_dataは何をするのか」といった質問を入力する。
- エージェントはナレッジグラフに基づいた詳細な回答を返し、新しい開発者が迅速にスピードアップできるようサポートします。
注目の機能操作
ナレッジ・グラフ・クエリー
ポットパイAIの核心は、コードベースのナレッジグラフである。開発者は自然言語でコード構造を照会できる:
- 例えば、"Show dependencies of data_processor.py "のようにクエリを入力します。
- エージェントは、ファイル間の呼び出し関係を示すビジュアルマップまたはテキスト説明を返します。
マルチ・モデル・スイッチング
- ある
config.yaml
でモデル設定を変更する:llm: provider: claude api_key: your-claude-key
- サービスを再起動すると、エージェントはコストやパフォーマンスの最適化に適した新しいモデルで実行される。
ほら
- モデルの選択オープンソース版ではラージモデルのAPIキーを自分で設定する必要があり、ホスト版ではデフォルトのモデルが提供される。
- コード・ベース・サイズ大規模なコードベースは、より多くのメモリを必要とする可能性があり、ハイエンドのサーバーで実行することをお勧めします。
- 地域支援: Potpie AIのDiscordコミュニティ(
discord.com/invite/potpie-ai
)、リアルタイムの助けを得る。
アプリケーションシナリオ
- 複雑なコードを素早くデバッグ
レガシーシステムを保守する際、開発者が複雑なスタックトレースから問題を見つけ出すのに苦労する中、Potpie AIのデバッグエージェントは、ナレッジグラフを通してコードロジックを分析し、エラーの根本原因を素早く特定し、デバッグ時間を短縮します。 - 自動テスト開発
チームは新機能のテストケースを書く必要がありますが、手作業で書くのは時間がかかります。ポットパイAIは、単体テストと統合テストのコードを自動的に生成し、コードの品質を確保し、手作業を減らします。 - 新規開発者のオンボーディング
ポットパイAIのQ&Aエージェントは、プロジェクトのセットアップや機能説明の詳細なガイドを提供し、新人がすぐにスピードアップできるよう支援します。 - コードレビューと最適化
コードをコミットする前に、開発者は変更の影響を評価する必要があります。potpie AIはコードの変更を分析し、潜在的な問題を特定し、コードの堅牢性を確保するための最適化を提案します。
品質保証
- ポットパイAIはすべてのプログラミング言語に対応していますか?
はい、Potpie AIはPython、JavaScript、TypeScriptなど複数のプログラミング言語をサポートしています。どの言語のコードベースでも、ナレッジグラフを通してコード構造を解析します。 - オープンソース版とホスティング版の違いは何ですか?
オープンソース版は無料で、環境とモデルのAPIキーを自分で設定する必要があり、技術スキルのあるユーザーに適している。ホスト型バージョンは、すぐに使えるサービスを提供し、迅速な展開に適している。 - エージェントのセキュリティを確保するには?
オープンソース版はローカルで実行され、プライバシーを確保するためにデータはクラウドにアップロードされない。ホスティング・バージョンは厳密なデータ保護プロトコルに従い、ユーザーはセルフホスティング・モデルを選択することができる。 - プログラミングの経験は必要ですか?
エージェントを作成するには、基本的なプロンプトを書くスキルが必要ですが、VS Code プラグインは、直感的なインターフェイスを提供し、使用への障壁を低くします。また、ドキュメントやコミュニティによるサポートも初心者に適しています。