> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/aide/limitations-and-faq.md).

# 制限事項とFAQ

Avonni MCP サーバーと Skills で対応していない内容、および一般的なセットアップ問題の解決方法です。

{% hint style="warning" %}
🚧 **早期アクセス。** Build with AI は段階的に展開され、リリースごとに改善されています。わかりにくい点、足りない点、壊れている点はありますか？ [お知らせください](/experience-cloud/experience-cloud-ja/herupu/how-do-i-contact-support.md): あなたのフィードバックが、次に改善する内容を直接形作ります。
{% endhint %}

## 制限事項

これらのツールは用途を絞って意図的に範囲を狭くしています。どこまで対応しないかを知っていれば、最初から作られていないことを期待せずに済みます。

* **Avonni コンポーネントのみで、サイト本体ではありません。** これらのスキルは、既存のサイトページに Avonni コンポーネントを追加・設定します。サイト、ページ、ルート、テーマ、ナビゲーションは作成しません。まず Experience Builder でそれらを作成し、その後 Avonni の要素をこのスキルに戻してください。
* **何もデプロイされません。** 各スキルはローカルでファイルを書き込みまたは編集して、そこで止まります。組織へプッシュすることはありません。変更のデプロイとサイトの公開は、Salesforce CLI または通常のデプロイ手順を使ってあなたが行ってください。
* **MCP サーバーは必須依存関係です。** スキルは推測するよりも、それがないと実行を拒否します。オフラインモードはありません。サーバーに到達できない場合、スキルは停止し、接続するよう求めます。
* **MCP サーバーは最新リリースのドキュメントを提供しますが、これはインストール済みパッケージより先行している場合があります。** ドキュメントサービスは Avonni パッケージのリリースごとに自動更新されます。組織が古いパッケージ版を使用している場合、アシスタントはまだ持っていないコンポーネントやプロパティを自信を持って使ってしまうことがあります。同期を保つため、インストール済みの Avonni パッケージを最新に保ってください。
* **Node.js と認証済みの Salesforce CLI は、どのクライアントでも作業の基盤です。** スキルは Node.js 18 以上を必要とするローカルスクリプトを実行し、Salesforce CLI はそれらを組織に接続して、ドキュメント検索、コンポーネントのバージョン照会、サイトコンテンツの取得・保存を行います。この基盤がないと、Claude デスクトップアプリでも、アシスタントはドキュメントを読むことはできても、実用的なものを生成できません。
* **architect は 4 つすべてではなく、3 つのアーティファクトスキルを調整します。** `avonni-architect` Experience、Flow、Dynamic Component の各スキルを統括します。 `avonni-lwc-components` 単独で呼び出す直接編集ワークフローです。

## トラブルシューティング

| 問題                                | 原因                                                                                                          | 対処                                                                                                                                                                |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| スキルが起動しない                         | スキルが、開いているアシスタントまたはプロジェクトにインストールされていません。The `npx skills add avonni/skills` コマンドは現在のプロジェクトにのみインストールします。      | 開いているプロジェクトからインストールコマンドを再実行し、スキルフォルダーをアシスタントのスキルディレクトリ（`.claude/skills/` Claude Code の場合）、またはアシスタントの［Skills］設定から再度追加してください。                                       |
| スキルが起動しない                         | プロンプトが曖昧すぎて、適切なスキルを起動できません。                                                                                 | 何を作っているのかを明示的に指定するか（「Avonni コンポーネント」「Experience Site ページ」）、スキル名で呼び出してください。Claude では、次を入力します: `/avonni-experience-components`.                                     |
| アシスタントが属性を参照せずに推測している             | MCP サーバーが接続されていません。                                                                                         | アシスタントの MCP 状態を確認してください（Claude Code では、次を実行します: `claude mcp list`）そしてサーバー URL を確認してください。次に次でテストします: *「利用可能な Avonni experience コンポーネントを一覧表示してください。」*               |
| スキルは実行されるものの、組織データの保存や参照ができません    | Node.js がないか、Salesforce CLI がインストールされていない、または組織への認証がされていません。                                                | Node.js 18 以上をインストールし、Salesforce CLI をインストールしてから、次を実行してください: `sf org login web` を実行して再試行してください。                                                                   |
| MCP 接続に失敗する                       | URL が違う、トランスポートが違う、またはサーバーが別のプロジェクトに追加されています。The `claude mcp add` コマンドは現在のプロジェクトにのみ登録します。                   | URL が次であることを確認してください: `https://mcp.avonnicomponents.com` HTTP トランスポートで。正しいプロジェクトからコマンドを再実行するか、より広いスコープで追加してください（Claude Code では、 `claude mcp add --scope user …`). |
| 私が存在を知っているコンポーネントをアシスタントが見つけられない  | ある `?toolsets=` フィルターがそのコンポーネントのパッケージを除外しています。With `?toolsets=experience`、flow、dynamic、LWC コンポーネントは表示されません。 | フィルターを削除するか、足りないパッケージを一覧に追加してください。                                                                                                                                |
| 複数アーティファクトの要求で、1 つの部分しか作成されませんでした | この `avonni-architect` スキルがインストールされていないため、単一アーティファクトのスキルは自分の担当部分しか処理できません。                                   | 確認してください。 `avonni-architect` 他のスキルと一緒にインストールされていること。                                                                                                              |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/aide/limitations-and-faq.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.