projects
personal project
みらい不動産 物件案内AIエージェント
Vercel AI SDK + Gemini を使い、物件検索・詳細確認・内見予約を複数ツールの連鎖で自律実行するAIエージェント。HMAC署名によるAPI保護とLangfuseによるLLM可観測性を実装しました。
tech stack
Next.jsTypeScriptVercel AI SDKGeminiHMACLangfuse
story
架空の不動産会社「みらい不動産」を舞台に、契約前の物件案内を担うエージェントとして設計。自作の不動産業務管理APIを「道具」として使い、検索して答えるだけでなく、状況を判断して多段で行動するAIエージェントを作りたいと考えました。ハウスメーカー営業6年の経験を、条件緩和の判断ロジックに反映しています。
顧客管理システムを見るhighlights
- —Human-in-the-loop承認ゲート（HMAC署名で承認内容と実行内容の改ざん・取り違えを防止）
- —決定的テストと実モデルevalsを分離した品質保証、Langfuseで可観測性を確保
- —検索0件時の自律的な条件緩和（前職の実務判断をルール化）
related system
不動産業務管理API
上のAIエージェントが「道具」として呼び出す、物件・問い合わせ・内見予約を管理するバックエンドAPI
HonoTypeScriptDrizzle ORMNeonVitestVercel
前職でハウスメーカーの営業を6年経験し、物件公開・問い合わせ・内見調整という業務フローや、そこで起こりがちな状態管理の問題を実務として理解しています。
- —状態遷移テーブルとトランザクション制御によるデータ整合性の担保（許可外の遷移は409で拒否、失敗時はロールバック）
- —JWT認証（アクセストークン15分＋リフレッシュローテーション）と、権限ごとに異なるWHERE句を構築する認可設計
- —zodスキーマからOpenAPI仕様を自動生成