AIエージェント
SidianのAIエージェントは、コードの記述、理解、リファクタリングを支援するインテリジェントなアシスタントです。このガイドでは、AIエージェントとの対話方法や、その能力を活用して開発プロセスを強化する方法について説明します。
AIエージェントの概要
Sidianは、開発のさまざまな側面を支援するために、いくつかの特化したAIエージェントを提供しています。
コードアシスタント
- コード補完と提案
- 関数とクラスの生成
- コードリファクタリング支援
- バグの検出と修正
解説エージェント
- コードの解説とドキュメンテーション
- アルゴリズム分析
- アーキテクチャに関する洞察
- 学習の推奨
AIエージェントとの対話
SidianのAIエージェントと対話するには、複数の方法があります。
チャットインターフェース
- サイドバーからAIチャットパネルを開く
- 自然言語で質問やリクエストを入力する
- AIは現在のコードに基づいて文脈に応じた回答を提供します
- 不明な点があれば追加の質問で深掘りする
インライン支援
- コードを選択して Ctrl+Shift+L を押すと解説が表示されます
- コードを右クリックしてコンテキストメニューオプションを使用
- キーボードショートカットでAIアクションを素早く実行
- エラーにホバーするとAIによる修正案が表示されます
プロのヒント: AIエージェントは、インポートされたライブラリ、コーディングパターン、プロジェクト構造など、あなたのプロジェクトの文脈を理解します。これにより、より正確で関連性の高い支援が可能になります。
エージェントの能力
コード生成
- 関数作成: 欲しいものを記述すれば、完全な関数が生成されます
- クラスのひな形作成: メソッドとプロパティを持つクラス構造を生成
- テスト生成: 既存のコードに対する単体テストを作成
- ドキュメンテーション: コメントやドキュメントを生成
コード分析
- バグ検出: コード内の潜在的な問題を特定
- パフォーマンス最適化: パフォーマンス向上のための改善案を提案
- セキュリティ分析: セキュリティの脆弱性を発見
- コード品質: ベストプラクティスやパターンを推奨
リファクタリング支援
- メソッドの抽出: 大きな関数を分割
- 変数の名前変更: ファイル間で一貫した命名規則を適用
- インポートの整理: インポートをクリーンアップして最適化
- コードのフォーマット: 一貫したスタイルを適用
ベストプラクティス
効果的なコミュニケーション
- 具体的に: 明確で詳細なリクエストを提供する
- 文脈を含める: プログラミング言語やフレームワークに言及する
- 追加の質問をする: 不明な点は遠慮なく質問する
- 例を提供する: 達成したいことを示す
コードレビュー
- 常にレビューする: AIが生成したコードをレビューなしで受け入れない
- 徹底的にテストする: テストを実行し、機能を確認する
- 変更を理解する: AIが何をしたかを確実に理解する
- スタイルを維持する: コードベースとの一貫性を確保する
プライバシーとセキュリティ
- 機密データ: 企業秘密や機密性の高いコードには注意する
- APIキー: APIキーや認証情報を決して共有しない
- 提案をレビューする: AIの提案がもたらすセキュリティ上の影響を確認する
- ローカル処理: 機密性の高いプロジェクトにはオフラインモードを使用する
高度な機能
カスタムプロンプト
共通のタスクに対して再利用可能なプロンプトを作成します:
// APIエンドポイント作成用のカスタムプロンプト
"Create a REST API endpoint for [resource] with CRUD operations using Express.js and MongoDB"コンテキスト管理
- ファイルコンテキスト: AIは現在のファイルと関連ファイルを考慮します
- プロジェクトコンテキスト: プロジェクト構造と依存関係を理解します
- 履歴コンテキスト: 過去の会話が現在の応答に反映されます
- 選択コンテキスト: 選択したコードに焦点を当てて的を絞った支援を行います
モデル選択
タスクに適したAIモデルを選択します:
- 高速モデル: 単純なタスクに対する迅速な応答
- 高度なモデル: 複雑な推論とコード生成
- 特化モデル: 言語特有またはドメイン特有のモデル
- ローカルモデル: プライバシーを重視したオフライン処理
トラブルシューティング
よくある問題
AIが応答しない
- クラウドモデルの場合: インターネット接続を確認
- ローカルモデルの場合: Ollama/LM Studioが実行中であることを確認
- アカウントステータスとサブスクリプションを確認
- AI接続をリフレッシュしてみる
不正確な提案
- リクエストにもっと文脈を含める
- 要件をより具体的にする
- 質問を言い換えてみる
- 別のAIモデルを使用する
パフォーマンスの問題
- 不要なファイルやタブを閉じる
- AIの会話履歴をクリアする
- より高速なAIモデルに切り替える
- システムリソースを確認する
ヘルプ
- ドキュメント: 包括的なガイドとチュートリアル
- サポート: Sidianチームからの直接的な支援
- フィードバック: 問題を報告し、改善を提案する
SidianのAIエージェントは、あなたのコーディングパートナーとして設計されており、スキルを学び向上させながら、より良いコードをより速く書く手助けをします。