ソフトウェアをAIエージェント向けツールに

すでに運用している業務ソフトウェアを、AIエージェントが明確な方法で利
用できるようにします。適した操作を特定し、入力と結果を記述し、権限を
確認してからツールとして公開します。変更は既存のアプリケーションと並
行して計画し、運用上の制約に合わせてテストと展開を合意します。

解きほぐす：画面からルールを取り出す

事業を動かすルールは、ソフトウェアに隠れています。フォームの検証、ス
トアドプロシージャ、誰も変更に踏み切れないレポート、開発した人の頭の
中などです。それらを見つけて文書化し、それぞれを一つの層、多くの場合
はデータベース自体に移します。そこでは、どの呼び出し元にも同じ答えが
返ります。画面、エージェント、提携先の連携システムは、別々のルールを
保守するのではなく、同じ実装済みのルールを利用します。

公開する：エージェントが呼べる、仕様付きのツール

エージェントに提供すべき各操作を、予約枠を取る、料金を見積もる、注文
の処理を許可するなど、仕事の内容に沿った名前のツールにします。型を定
めた入力、エージェントが次の行動を取れるエラー、再試行でも二重に予約
しない冪等な呼び出しを備えます。説明はコードから生成するOpenAPI文書
とし、MCPサーバーでも、対応するエージェントに同じ操作を提供します。
認証にはOAuthを使い、パスワードを受け渡さず、利用者の権限の範囲内だ
けで、その代理として動作させます。

操作を管理された手順で段階的に展開する

選んだ操作を既存のアプリケーションと並行して公開し、新しい経路と現在
の挙動を比較します。時間のかかる処理は、適する場合にキューへ移せま
す。展開前に、依存関係、移行の必要性、保守時間帯、ロールバックを評価
します。合意した構成で可能な場合は、既存の画面を引き続き利用できるよ
うにします。中断が必要な場合は、サービスの運用担当者と計画します。

API仕様を生成し、ずれを検査する

構成が対応する場合、データベースとAPIの定義から仕様を生成し、公開さ
れたAPI仕様と実装を比較します。検査によって対象操作の不一致を特定
し、互換性の変更をレビューで確認できるようにします。テストと、その対
象範囲も引き継ぎに含めます。仕様を生成しただけで、すべての挙動の正し
さが証明されるわけではありません。

取り組みを裏付ける実績

大規模なシステムを、この方法で外部から使えるようにしてきました。各段
階に検査を設けて、データベースを起点にAPI契約を生成し、760操作のAPI
を、公開仕様との一致率100%で移行しました。PostgreSQLからAPIへのJSON
パススルーを設計し、業務ルールを一か所に置く、層を明確に分けたプラッ
トフォームを構築し、時間のかかる処理をジョブキューへ移し、データベー
スへ直接アクセスせずに運用できる運用担当者向けの管理画面を構築しまし
た。

ご依頼の進め方

まず、担当者が日々ソフトウェアで行う操作を一覧にし、頻度と負担の大き
さで並べます。最初のいくつかの操作を選んでルールを見つけ、テストと権
限で保護した、仕様付きのツールとして公開します。画面を置き換えるので
はなく、並行して動かします。その後、次の操作に進みます。コード、テス
ト、仕様はお客様のチームに残ります。ツールは、業種に合わせて構築した
エージェント、従業員がすでに使うアシスタント、提携先のシステムから呼
び出せます。他の仕事と同じく、料金に記載する条件でご依頼いただけま
す。

誰かがクリックしないと動かないソフトウェアをお使いでしたら、その内容
をお聞かせください (エンジニアが読みます)。

hこのページのウェブ版	URL:https://support.engineer.company/ja/ai-tools/	support.engineer.company	70
