{"canonical_url":"https://engineer.company/ja/ai-tools/","content_markdown":"# ソフトウェアをAIエージェント向けツールに\n\nすでに運用している業務ソフトウェアを、AIエージェントが明確な方法で利用できるようにします。適した操作を特定し、入力と結果を記述し、権限を確認してからツールとして公開します。変更は既存のアプリケーションと並行して計画し、運用上の制約に合わせてテストと展開を合意します。\n\n## 解きほぐす：画面からルールを取り出す\n\n事業を動かすルールは、ソフトウェアに隠れています。フォームの検証、ストアドプロシージャ、誰も変更に踏み切れないレポート、開発した人の頭の中などです。それらを見つけて文書化し、それぞれを一つの層、多くの場合はデータベース自体に移します。そこでは、どの呼び出し元にも同じ答えが返ります。画面、エージェント、提携先の連携システムは、別々のルールを保守するのではなく、同じ実装済みのルールを利用します。\n\n## 公開する：エージェントが呼べる、仕様付きのツール\n\nエージェントに提供すべき各操作を、予約枠を取る、料金を見積もる、注文の処理を許可するなど、仕事の内容に沿った名前のツールにします。型を定めた入力、エージェントが次の行動を取れるエラー、再試行でも二重に予約しない冪等な呼び出しを備えます。説明はコードから生成するOpenAPI文書とし、MCPサーバーでも、対応するエージェントに同じ操作を提供します。認証にはOAuthを使い、パスワードを受け渡さず、利用者の[権限](/ja/ai-security/)の範囲内だけで、その代理として動作させます。\n\n## 操作を管理された手順で段階的に展開する\n\n選んだ操作を既存のアプリケーションと並行して公開し、新しい経路と現在の挙動を比較します。時間のかかる処理は、適する場合にキューへ移せます。展開前に、依存関係、移行の必要性、保守時間帯、ロールバックを評価します。合意した構成で可能な場合は、既存の画面を引き続き利用できるようにします。中断が必要な場合は、サービスの運用担当者と計画します。\n\n## API仕様を生成し、ずれを検査する\n\n構成が対応する場合、データベースとAPIの定義から仕様を生成し、公開されたAPI仕様と実装を比較します。検査によって対象操作の不一致を特定し、互換性の変更をレビューで確認できるようにします。テストと、その対象範囲も引き継ぎに含めます。仕様を生成しただけで、すべての挙動の正しさが証明されるわけではありません。\n\n## 取り組みを裏付ける実績\n\n大規模なシステムを、この方法で外部から使えるようにしてきました。各段階に検査を設けて、[データベースを起点にAPI契約を生成](/ja/portfolio/generated-the-api-contract-from-the-database-out/)し、[760操作のAPIを、公開仕様との一致率100%で移行](/ja/portfolio/migrated-the-api-to-huma-v2-at-100-parity/)しました。[PostgreSQLからAPIへのJSONパススルーを設計](/ja/portfolio/designed-a-json-passthrough-from-postgres-to-api/)し、[業務ルールを一か所に置く、層を明確に分けたプラットフォーム](/ja/portfolio/a-maritime-platform-built-in-clean-layers/)を構築し、[時間のかかる処理をジョブキューへ移し](/ja/portfolio/moved-slow-work-onto-a-river-job-queue/)、データベースへ直接アクセスせずに運用できる[運用担当者向けの管理画面](/ja/portfolio/built-the-operator-back-office-for-the-platform/)を構築しました。\n\n## ご依頼の進め方\n\nまず、担当者が日々ソフトウェアで行う操作を一覧にし、頻度と負担の大きさで並べます。最初のいくつかの操作を選んでルールを見つけ、テストと権限で保護した、仕様付きのツールとして公開します。画面を置き換えるのではなく、並行して動かします。その後、次の操作に進みます。コード、テスト、仕様はお客様のチームに残ります。ツールは、[業種に合わせて構築したエージェント](/ja/ai-agents/)、従業員がすでに使うアシスタント、提携先のシステムから呼び出せます。他の仕事と同じく、[料金](/ja/what-it-costs/)に記載する条件でご依頼いただけます。\n\n誰かがクリックしないと動かないソフトウェアをお使いでしたら、[その内容をお聞かせください](/ja/contact/) *(エンジニアが読みます)*。\n\n\u003chttps://engineer.company/ja/ai-tools/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"選んだソフトウェア操作を、仕様を記述したAIエージェント向けツールとして公開します。権限、API仕様の整合性検査、計画的な展開を備えます。","formats":{"gemtext":"https://software.engineer.company/ja/ai-tools/index.gmi","gopher":"https://software.engineer.company/ja/ai-tools/gophermap","html":"https://software.engineer.company/ja/ai-tools/","json":"https://software.engineer.company/ja/ai-tools/index.json","markdown":"https://software.engineer.company/ja/ai-tools/index.md","pdf":"https://software.engineer.company/ja/ai-tools/index.pdf"},"kind":"page","language":"ja","title":"ソフトウェアをAIエージェント向けツールに","url":"https://software.engineer.company/ja/ai-tools/","version":1}