AIエージェントが検索や要約だけでなく、フォーム入力まで担うようになると、自分のサイトにもAPIやMCPが必要に思えてくる。しかし、入口を先に作ると、使われない仕組みや過剰な権限を抱えやすい。

先に決めるべきなのは技術ではなく、AIに任せる仕事である。公開情報を読むだけなのか、在庫や価格を照会するのか、注文や設定を変更するのか。サイトに必要な入口は、この分類と失敗時の影響で決まる。

「読む・照会する・操作する」で入口を選ぶ

同じ「AIから使えるサイト」でも、必要な設計は一つではない。読むだけなら公開ページの整理が効く。照会には安定したデータ形式が要る。操作まで許すなら、権限や回復手段なしには進められない。

AIがすること用意するもの急がなくてよいもの
記事を読む、要約する、引用するmetadata、明確なtitleとdescription、日付、category、canonical、RSS、sitemap、404 / 410の状態表示専用APIやMCPをすぐ作ること
在庫、価格、講座状態を照会する安定したデータ形式、照会ルール、更新時刻、明確なエラーagentにHTML構造を推測させること
フォーム送信、注文作成、設定変更をする権限、rate limits、確認ステップ、logs、review、recovery不可逆な操作をAIへ直接渡すこと
社内ワークフローや複数ツールをつなぐ正式なAPI / MCP / adapter、logs、monitoring、rate limits、review、recovery、停止ルール壊れやすいスクレイピングを長期運用すること

判断基準は入口の新しさではなく、誤読や誤操作が起きたときの損失である。支払い、権限変更、顧客への約束、削除、社内ワークフローに触れる処理には、人の承認と記録、停止、復旧を組み込む必要がある。AIエージェントにコードを任せる前に、タスクへチェックポイントを入れるで扱う停止点は、この種の操作入口にもそのまま使える。

公開情報を整え、必要な範囲だけ機械に開く

記事、チュートリアル、ポートフォリオが中心なら、最初の仕事はAPI開発ではない。metadataのtitle、description、日付、categoryを明確にし、canonical、RSS、sitemapが正しいページを示すようにする。削除や移転も曖昧にせず、404 / 410で状態を伝える。これだけで、AIが古いページを引用したり、存在しない情報を探し続けたりする可能性を下げられる。

公開情報では足りず、在庫、価格、講座状態を繰り返し参照する需要が確認できたら、対象を絞った読み取り専用APIを検討する。フォーム、注文、設定を扱う段階では、まず下書きや確認待ちとして受け付ける。正式な実行権限を与えるのは、logs、monitoring、rate limits、review、recoveryの担当が決まった後でよい。途中で失敗する処理では、自動化が途中で失敗したら、誰が後始末をするのかまで先に決めておく必要がある。

次にやることは一つだけである。AIに任せたい実際の作業を一件選び、「読む・照会する・操作する」のどれかに分類し、読むだけならmetadata、canonical、RSS、sitemap、404 / 410の現状確認から始める。

広告

AI整理カード

利用できる記録を読み取り専用で調べ、サイトに必要な入口を一つの判断に絞るための指示である。

現在アクセスできるワークスペース、リポジトリ、プロジェクト、サイトの記録から始め、変更を加えず読み取り専用で調査せよ。読者に事前資料の作成や情報の転記を求めてはならない。アクセスできない記録が判断に不可欠な場合だけ、アクセス方法について質問を一つまで行うこと。

まず、AI用の入口に関する具体的な問題を一つ特定せよ。AIが公開情報を読むだけなのか、在庫・価格・講座状態などを照会するのか、フォーム・注文・設定を操作するのかを判定し、その根拠として実際のファイル、設定、ページ、ログ、エラー、運用記録の場所を示せ。

確認項目は次の通りとする。
- 公開発見性:metadata、title、description、日付、カテゴリ、canonical、RSS、sitemap、404、410の状態
- 照会入口:データ形式、更新状態、エラー処理、読み取り範囲
- 操作入口:フォーム、注文、設定に対する権限、確認、記録、取り消し手段
- 高リスク領域:支払い、権限、顧客への約束、削除、社内ワークフロー
- 制御手段:API、MCP、adapter、ログ、監視、レート制限、人間レビュー、障害時の回復

出力では「確認できた事実」と「事実からの推論」を分けること。記録から確認できない項目は推測で埋めず、必ず「要確認」と記すこと。結論は次の四つから一つだけ選ぶこと。
1. 公開入口を整える
2. 読み取り専用の機械入口を範囲限定で試す
3. 人間の承認と回復手段を備えた操作入口を設計する
4. 現時点では機械用入口を追加しない

最後に、今日実行できる最小の一手を一つ示せ。支払い、権限変更、顧客への約束、削除、外部送信、不可逆な処理は自動実行せず、人間の承認点、担当者、必要なログ、停止条件、戻し方を明記せよ。

人間の確認点:提案された入口が実際の用途より広くないかを確かめ、支払い、権限、顧客への約束、削除、外部送信を含む変更は、担当者と回復手段が決まるまで承認しない。

日常の四コマ

二つの曖昧な入口を前に配達員が滞留し、店主が片方を閉じて受け取り窓口と列を整える四コマ漫画

  1. 二つの扉があるものの、どちらが受け取り口か分からない。配達員は荷物を持ったまま互いの様子をうかがっている。
  2. 配達員が次々に到着し、入口で質問と確認が重なる。荷物を渡す経路が決まっていないため、列は動かない。
  3. 店主はいったん受け渡しを止め、片方の扉を閉じる。代わりに受け取り専用の窓口を開き、列を示すロープを設ける。
  4. 確認できた一件だけが窓口から引き渡され、残りは順番と条件が整うまで保留になる。サイトも同じで、まず入口を明確にし、高リスクな処理ほど制御された経路に限定する必要がある。
広告

Share

このミニクラスを共有

このミニクラスが仕事の詰まりをほどく助けになったら、AI の使い方を考えている人にも共有してください。

参考文献