Ops Deck Lite

巨大なエージェントダッシュボードを構築する前に、2つの小規模なローカルサービスを構築します。

目標

エージェントに即座に成果が得られる2つの機能を提供します:

1. セマンティックコード検索
2. 再利用可能なプロンプトライブラリ

コンポーネント1: セマンティックコード検索

コード内を意味で検索し、完全一致のテキスト検索に限定しません。

以下のようなクエリに有用です:

• 認証ミドルウェア
• リトライロジック
• データベースプーリング
• エラーハンドリング

コア設計

• ソースファイルをチャンク化する
• ローカルまたは管理下にあるプロバイダーを通じてエンベディングを生成する
• チャンク、メタデータ、オプションで要約を小規模なデータベースに保存する
• 複数のモード(hybrid、code、summary)を備えた1つの検索エンドポイントを公開する

コンポーネント2: プロンプトライブラリ

毎回セッションでプロンプトを書き直すのではなく、再利用可能なテンプレートとしてプロンプトを保存します。

各プロンプトには以下を含める必要があります:

• タイトル
• カテゴリ
• 本文
• オプションのタグ
• オプションの変数

このスタックが機能する理由

• 実行コストが安い
• デフォルトでプライベート
• バックアップが簡単
• 人間とエージェント双方にとって有用
• 完全な運用スイートより影響範囲がはるかに小さい

最小限のセットアップガイダンス

お好みのスタックを使用できますが、シンプルな構造を維持してください:

• 1つのコード検索API
• 1つのプロンプトライブラリAPI
• サービスごとに1つの小規模データベース、または必要に応じて共有ストレージ
• 1つの軽量プロセスマネージャーまたはサービススーパーバイザー

エージェント統合パターン

エージェントに2つの習慣を教えます:

1. 数十ものファイルをgrepする前に、セマンティックコード検索を確認する。
2. ゼロからプロンプトを作成する前に、プロンプトライブラリを確認する。

推奨されるAPIの形状

コード検索

• POST /api/search
• GET /api/health
• POST /api/index

プロンプトライブラリ

• GET /api/prompts
• GET /api/prompts/:id
• POST /api/prompts
• PUT /api/prompts/:id
• DELETE /api/prompts/:id

検証

優れたスモークテスト:

• ソースコードに文字通りは存在しないコンセプトをクエリする
• セマンティック検索が正しい領域を見つけることを確認する
• カテゴリで既知のプロンプトを取得し、正常に再利用する

アンチパターン

完全なコントロールプレーン、アナリティクスウォール、スプリントボード、7つのサイドパネルを備えた構成から始めてはいけません。トークンと時間を実際に節約する2つのツールから始めてください。