カスタム文言（ツールの「表示文言」と、返信待機スタイルのツールカテゴリ文言表）では、次の変数を使用できます。
| 変数 | 挿入される内容 |
| ------------- | -------------------------------------------- |
| `{{tool}}` | ツールの表示名 |
| `{{subject}}` | 今回のクエリの対象（検索キーワード、URL、ファイル名など） |
| `{{result}}` | 結果の要約（「7 件の結果」など）。完了ステータスでのみ値があります |
| `{{パラメータ名}}` | ツール入力の最上位パラメータ（`{{query}}`、`{{orderId}}` など） |
* 値のない変数は空文字列として表示され、隣接する「：」「·」や空の括弧も一緒に削除されます。
* カスタム文言は書いた内容のまま表示され、システムが自動的に検索対象や結果数を後ろに付けることはありません。必要な場合は、ご自身で `{{subject}}` や `{{result}}` を入れてください。
* カスタム文言は会話の言語に応じて選択されます。その言語の文言が入力されていない場合は、デフォルト言語（英語）のカスタム文言が使われます。どちらもない場合は、まず組織で設定されたツールカテゴリの文言（同様に会話の言語、次にデフォルト言語の順で探します）が使われ、それでもなければプラットフォームのデフォルト文言が表示されます。たとえば、ツールに繁体字中国語の文言のみが入力されている場合、英語の会話ではまず組織で設定された英語のカテゴリ文言が使われ、組織で未設定の場合にのみ英語のプラットフォームデフォルト文言が表示されます。
* 「表示文言」で設定できるのは、実行中と完了後の 2 種類の文言のみです。ツールの結果が 0 件の場合は完了後の文言が使われます。ツールの実行が失敗した場合は、まず組織で設定された該当カテゴリの失敗文言が使われ、組織で未設定の場合にのみプラットフォームのデフォルトの失敗文言が表示されます。
## モード選択のおすすめ
* ユーザーがツールの結果を確認する必要がある場合は、「フル」を選択します。
* ユーザーがシステムが処理中であることだけを知ればよい場合は、「簡易」を選択し、分かりやすい表示文言を組み合わせます。
* 実行の詳細を会話内に表示すべきでない場合は、「非表示」を選択します。
設定が完了したら、ツールをテスト用の Agent に設定して実際に質問を送信し、表示文言と出力テンプレートがツールが実際に返すフィールドに合っていることを確認することをおすすめします。
## MCP インタラクティブカード（MCP Apps）
一部の MCP サーバーは、データを返すだけでなく、インタラクティブな画面も添付します。Agent が呼び出すと、会話内に直接操作できるカードが表示されます。カードは上記の「表示モード」の影響を受けません。「非表示」を選択しても、インタラクティブカードは表示されます。カードの表示方法、条件、セキュリティ上の制限、よくある質問については、[MCP インタラクティブカード（MCP Apps）](/maiagent-user-guide/ja/build/tools/mcp-apps.md)をご参照ください。
---
# 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.maiagent.ai/maiagent-user-guide/ja/build/tools/tool-display-settings.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
