「自社サイトの情報をAIに正しく使ってもらいたい」「ChatGPTやGoogleのAIエージェントから直接自社のサービスを呼び出してほしい」と考えたことはありませんか。2026年現在、検索エンジンの進化により、ユーザーはWebサイトを訪れる前にAIとの対話だけで情報を完結させる「ゼロクリック検索」が当たり前となりました。

こうした時代背景において、Webサイトに求められるのは「人間が見るためのページ」だけではありません。AIがサイトの機能やコンテンツを理解し、活用するための「接点」を作ることが不可欠です。その鍵を握るのが、.well-known/ai-plugin.json という設定ファイルです。

この記事では、.well-known/ai-plugin.json の具体的な書き方から、自社サイトをAIの「ツール」へと進化させるための実装戦略までを専門的な視点で解説します。AIとの共生を目指す次世代のWebサイト設計を、今すぐ始めましょう。

目次

.well-known/ai-plugin.jsonとは AIとサイトを繋ぐ名刺

.well-known/ai-plugin.json は、AI（特にChatGPTのプラグインやOpenAI Actions、各種AIエージェント）に対して、「このサイトにはどんな機能があり、どうやって呼び出せばいいのか」を伝えるための定義ファイルです。

Webサーバーの特定のディレクトリ（.well-known/）に配置することで、AIが自動的にこのファイルを読み取り、サイトが提供するAPIやコンテンツをツールとして認識できるようになります。

2026年現在のAIエージェント市場では、Agent2Agent（A2A）プロトコルなどの普及により、こうした「構造化された自己紹介」の重要性がさらに増しています。

BERYLによるメディア戦略の視点

メディア特化型ヘッドレスCMS BERYL（ベリル）では、コンテンツが最初から「構造化データ（JSON）」として管理されています。

そのため、.well-known/ai-plugin.json を通じてAPIエンドポイントを公開する際も、特定の「型」に沿ったクリーンなデータをAIに渡すことができ、AIによる誤認（ハルシネーション）を防ぐ精度の高い連携が可能になります。

ai-plugin.jsonの基本構造と書き方

このファイルはJSON形式で記述され、プラグインの名前、説明、認証方法、そしてAPIの定義（OpenAPI仕様書へのリンク）などが含まれます。

以下に、標準的な ai-plugin.json の記述例を示します。

JSON

{ "schema_version": "v1", "name_for_human": "BERYL サポートツール", "name_for_model": "beryl_support_tool", "description_for_human": "BERYLの最新記事や導入事例を検索し、最適なCMS運用案を提案します。", "description_for_model": "Help the user find articles about BERYL CMS, case studies, and technical documentation.", "auth": { "type": "none" }, "api": { "type": "openapi", "url": "https://example.com/openapi.yaml", "is_user_authenticated": false }, "logo_url": "https://example.com/logo.png", "contact_email": "support@example.com", "legal_info_url": "https://example.com/legal" }

主要パラメータの解説

項目名 内容 AIへの影響
name_for_model AIが識別するための内部名 AIがツールを選択する際の識別子になる
description_for_model AI向けの機能説明（最重要） どんな時にこのツールを使うべきかAIが判断する基準
api.url OpenAPI（Swagger）の定義ファイルパス 実際のデータ取得先やパラメータをAIが理解する

プロの視点 description_for_model の最適化

この項目は、AIが「今、このツールを使うべきか」を判断するプロンプトとして機能します。「キーワード検索ができる」といった抽象的な表現ではなく、「2024年以降の最新の導入事例を、業種別にフィルタリングして取得できる」といった、具体的な能力と制限を明記することが、AIに選ばれるためのコツです。

自社サイトを「AIのツール」にする3つのステップ

単にファイルを置くだけでは不十分です。AIに「使い勝手の良いツール」として認識されるためには、以下のステップで環境を整える必要があります。

1. APIエンドポイントの整備

AIがアクセスするためのAPIが必要です。情報を取得するだけの「GET」リクエストだけでなく、申し込みや予約を行う「POST」リクエストを含めることで、サイトは「閲覧用」から「実行用」へと進化します。

2. OpenAPI（Swagger）仕様書の作成

ai-plugin.json からリンクする openapi.yaml（またはjson）を作成します。ここでは、各APIがどのような引数（パラメータ）を受け取り、どのような形式でレスポンスを返すかを定義します。

3. ヘッドレスCMSによるデータ管理の標準化

AIに渡すデータがバラバラなフォーマットでは、AIは正しく要約できません。

「メディア特化型ヘッドレスCMS BERYL」なら、記事タイトル、公開日、タグ、本文といった要素が常に一定の構造で出力されるため、API連携時のデータ整形コストを大幅に削減できます。

AI連携におけるセキュリティと注意点

自社のデータをAIに開放する際、最も注意すべきはセキュリティです。.well-known ディレクトリに置くファイルは全世界に公開されるため、以下の対策が必須となります。

  • 認証の適切な設定: 誰でも実行できてよい検索APIと、個人情報を扱うAPIで認証レベル（OAuth2など）を分ける。
  • レートリミットの導入: AIエージェントからの過剰なアクセス（スクレイピング攻撃）を防ぐための制限をかける。
  • 露出情報の精査: 公開してはいけない内部管理用のIDや、未公開コンテンツがAPI経由で見えないように制御する。

BERYLによるセキュリティ解決

BERYLは管理画面と表示部が物理的に分離した「ヘッドレス構造」を採用しています。

APIサーバー側でホワイトリスト制御やAPIキー認証を細かく設定できるため、従来のCMSのように「管理画面への攻撃リスク」を抱えたまま外部連携を行う危険性を最小限に抑えられます。

.well-known/ai-plugin.jsonに関するよくある質問

ai-plugin.jsonを置くだけでChatGPTに表示されますか

いいえ、ファイルを配置した上で、OpenAIの管理画面（GPTsの設定やプラグイン開発者用コンソール）からマニフェストファイルを登録する必要があります。ただし、2026年現在のAI検索（SGE等）は、配置されているファイルを自動的にクロールして参照する場合もあります。

description_for_modelは日本語でも大丈夫ですか

基本的には英語での記述が推奨されます。AIモデルの多くは英語での指示をより正確に理解する傾向があるため、日本語のサイトであってもこの項目は英語で記述し、必要に応じて日本語を併記するのがベストプラクティスです。

ヘッドレスCMSでないと実装できませんか

実装自体は可能ですが、非常に困難です。従来のCMS（WordPressなど）はHTMLを出力することを主目的としているため、AIが処理しやすい「純粋なデータ（JSON）」を動的に、かつ一貫性を持って提供するには、多くのプラグインやカスタマイズが必要になり、保守性が低下します。

まとめ AI時代のWebサイト戦略 BERYLで実現する

.well-known/ai-plugin.json の実装は、単なる技術的な設定ではなく、「AIエージェントに自社サービスを使ってもらうための営業資料」をWeb上に置く行為です。2026年、ユーザーが直接サイトを訪れない未来において、このファイルがあるかどうかが、ビジネスの明暗を分けるかもしれません。

  • 構造化されたデータ提供: AIが理解しやすい「型」を持つメディア運営。
  • セキュアなAPI連携: フロントとバックを分離した安全な外部露出。
  • 高速なレスポンス: AIを待たせないパフォーマンスの確保。

これらを一気通貫で実現するのが、メディア特化型ヘッドレスCMS BERYLです。あなたのWebサイトを、ただの「ページ」から、世界中のAIが活用する「強力なツール」へとアップデートしませんか。

AIエージェント連携や、次世代のCMS構築に関するご相談は、ぜひBERYLまでお気軽にお問い合わせください。

 

この記事を書いた人
BERYL
BERYL編集部
「BERYL編集部」は、Web制作、CMS関連、Webマーケティング、コンテンツマーケティング、オウンドメディアなど、多岐にわたる分野で専門的な記事を制作しています。デジタル領域における最新の技術動向や実践的な事例を通じて、マーケティング戦略を強化するための情報を発信いたします。 また、SEO対策やコンテンツの最適化にも注力。ユーザー目線でわかりやすく解説し、企業のマーケティング活動やコンテンツ運営をサポートします。