> 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/using-the-ai-assistant.md).

# AIアシスタントの使用

やりたいことを平易な言葉で説明すると、適切なスキルが起動し、MCP サーバーを通じて正確なコンポーネント情報を参照します。

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

あなた自身でスキルや MCP ツールを呼び出す必要はありません。結果を平易な言葉で説明すると、アシスタントが適切なスキルを起動し、MCP サーバーを通じて実際のコンポーネント情報を参照します。

## 適切なスキルが自動で起動します

| 取り組んでいるのは…                                 | 起動するスキル                        |
| ------------------------------------------ | ------------------------------ |
| Digital Experience サイトページ上の Avonni コンポーネント | `avonni-experience-components` |
| スクリーンフロー内の Avonni Flow Screen Components   | `avonni-flow-components`       |
| Avonni Dynamic Component                   | `avonni-dynamic-components`    |
| LWC コード（HTML/JS/CSS）内の Avonni コンポーネント      | `avonni-lwc-components`        |
| 複数のアーティファクト種類にまたがるもの、またはビジネスユースケース         | `avonni-architect`             |

{% hint style="info" %}
**目安：** 既知の種類の単一アーティファクトは、それぞれ専用のスキルに割り当てられます。アーティファクトの種類をまたぐ依頼や、エンドツーエンドのユースケースを説明する依頼は `avonni-architect`に割り当てられます。迷ったら、目的だけを説明してください。どのスキルを起動するかは、そのスキルの起動ルールが判断します。
{% endhint %}

## プロンプトの例

以下のどれかをコピーし、オブジェクト名を自組織に合わせて調整して送信してください。コンポーネントは、このドキュメントで使用している名前、つまり「Data Table」「Kanban」「Gallery」「Banner」で参照してください。アシスタントは MCP サーバーを通じて各名前を適切なコンポーネントに解決します。

{% tabs %}
{% tab title="🆕 コンポーネントを追加" %}

> サポートポータルページに、ステータス別にグループ化した Case の Avonni Kanban を追加してください。

> アカウントページに、顧客の未処理の Order の Avonni Data Table を追加してください。

> ホームページに、製品画像の Avonni Gallery を追加してください。

**起こること：** その `avonni-experience-components` スキルが起動し、MCP サーバーを通じて各コンポーネントの実際のプロパティとインタラクションを参照し、設定済みのコンポーネントをサイトページに追加します。データの表示は引き続き組織の共有ルールに従います。ポータルユーザーが見られるのは、自分がアクセス権を持つレコードだけです。
{% endtab %}

{% tab title="✏️ ページを更新" %}

> Kanban のグループ化をステータスから優先度に変更してください。

> Data Table には未解決の Case のみを表示してください。

> Banner のタイトルと背景画像を変更してください。

**起こること：** スキルがページのコンテンツファイルを読み取り、MCP サーバーを通じてコンポーネントのオプションを確認し、変更を適用します。
{% endtab %}

{% tab title="⚡ インタラクションを接続" %}
インタラクションは、ページ上から直接、コンポーネントのイベントをアクションに接続します。

> ユーザーがボタンをクリックしたときに、ダイアログでスクリーンフローを開きます。

> 行がクリックされたときにレコードページへ移動します。

> ポータルユーザーが添付ファイルをダウンロードできるようにします。

**起こること：** スキルが、MCP サーバーの実際のインタラクションカタログを使用して、適切なインタラクションタイプ（Open Flow Dialog、Navigate、Download、Show Toast）とその設定を接続します。
{% endtab %}

{% tab title="🧩 完全なユースケース" %}

> サポートポータルページにケース一覧を追加し、ボタンから開くケース作成用の画面フローも追加してください。

これは 2 つのアーティファクト種類にまたがるため、 `avonni-architect` が起動します。アーキテクチャを計画し、まずフローを作成してから、そのフローを開くようにボタンを接続した状態でコンポーネントをページに追加します。

**起こること：** 1 つの依頼、複数のアーティファクト、すべて依存関係の順序で連携。
{% endtab %}
{% endtabs %}

## 期待できること

通常のセッションは 3 つのステップで進みます：

{% stepper %}
{% step %}

### 参照

アシスタントは、関係するコンポーネントについて、プロパティ、インタラクション、スタイル設定を含めて MCP サーバーに問い合わせます。
{% endstep %}

{% step %}

### 計画

アプローチを提案し、必要に応じて確認質問をします。複数アーティファクトの依頼では、アーティファクトを依存関係の順序で整理します。
{% endstep %}

{% step %}

### 生成

サイトページのコンテンツファイルを作成または更新します。内容を確認し、いつもの手順でデプロイしてから、Experience Builder でページを開いて結果を確認し、サイトを公開してください。
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
組織にデプロイされることはありません。デプロイと公開は引き続きお客様側で行います。「制限事項と FAQ」を参照してください。
{% endhint %}


---

# 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/using-the-ai-assistant.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.