---
schema_version: "1"
id: 7f02cc4c2c4a1afa21ba886bd68241406f09ffc6ca100428cf9f7376072cb6bc
title: 意図的 - 読みやすさ
collection: architect
version: next
locale: ja-jp
portal_url: https://docs.salesforce.com/architect/next/ja-jp/well-architected-tools/guides/easy-readability.md
canonical_url: https://staging.architect.salesforce.com/docs/architect/ja-jp/well-architected-tools/guide/easy-readability.html
source_site: staging.architect.salesforce.com
content_type: documentation
content_hash: 1db327ce208aeeaa66031145915c258b1bc7c47dc454bb056c75010ec250459b
products:
- 適切に設計されたツール
- Architect Site Content Repo
---
# 意図的 - 読みやすさ
### 設計標準パターン
適切に設計された \[[容易](/docs/architect/ja-jp/well-architected/guide/easy-overview)] → \[[意図的]](/docs/architect/ja-jp/well-architected/guide/intentional) → \[[読みやすさ](/docs/architect/ja-jp/well-architected/guide/intentional#読みやすさ)] → \[[設計標準]](/docs/architect/ja-jp/well-architected/guide/intentional#設計標準) についての詳細
| Where to look?
商品領域 \| ロケーション | What does good look like? (良いものは?)
パターン |
| ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Einstein \| エージェント | ✅ エージェントの言語設定が会社の口調と一致する 会社の口調が金融機関など正式な場合、エージェントの口調設定は「正式」になります。会社が非公式の場合、トーン設定は「カジュアル」になります。それ以外の場合、トーン設定は「ニュートラル」になります。 |
| Einstein \| 組織 | ✅ プロンプトテンプレートでは書式設定を活用して LLM にコンテキストを提供します。 1 つのハッシュを使用して、短いテキストブロックをプロンプトテンプレートコンテキストの 1 つの単位としてマークします。 |
| Einstein \| 組織 | ✅ プロンプトテンプレートでは一貫した書き方が使用されます。単語の選択、書式設定、絵文字、句読点はテンプレート全体で一貫しています。 |
| Einstein \| 組織 | ✅ プロンプトテンプレートは簡潔でわかりやすく、自然言語を使用します。テンプレートは業界の専門用語や専門用語を避ける |
| Einstein \| 組織 | ✅ プロンプトテンプレートは、コンテキストと手順を明確に示します。プロンプトでコンテキストを指定したら、テキスト「Instructions」で新しい行を開始し、その後に指示を三重引用符 ("") で囲みます。 |
| プラットフォーム \| ビジネス | ✅ 承認された AI モデルが明確に識別され、目的が含まれている |
| プラットフォーム \| ビジネス | ✅ 承認済みデザインパターンは使用事例で見つけやすく識別しやすい |
| プラットフォーム \| ビジネス | ✅ チームは、作業を完了するために使用すべき (使用すべきでない) ツールを把握する |
| プラットフォーム \| 組織 | ✅ コードおよび宣言型カスタマイズには、一貫性のある判読可能な名前を付ける |
| プラットフォーム \| 組織 | ✅ データモデルには、オブジェクトと項目の一貫した統一した名前が付けられている |
| プラットフォーム \| 組織 | ✅ 監査では、項目が一貫して入力され、レポートなどで参照されていることが示されます。 |
### ドキュメントパターン
適切に設計された [容易](/docs/architect/ja-jp/well-architected/guide/easy-overview) → [意図的](/docs/architect/ja-jp/well-architected/guide/intentional) → [読みやすさ](/docs/architect/ja-jp/well-architected/guide/intentional#読みやすさ) → [ドキュメント](/docs/architect/ja-jp/well-architected/guide/intentional#ドキュメント)
| Where to look?
商品領域 \| ロケーション | What does good look like? (良いものは?)
パターン |
| ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Data 360 \| ドキュメント | ✅ ソースシステムはデータ辞書でインベントリされる Data 360 データソースは、ソースシステムとターゲットシステム、および 2 つの間の項目の対応付けを含むデータ辞書を使用してソリューション設計プロセスで文書化されます。 |
| プラットフォーム \| ビジネス | ✅ すべてのソリューションのビジネス能力と技術的な実装の詳細を示す図が存在する |
| プラットフォーム \| ビジネス | ✅ コードおよび宣言型カスタマイズで誰が/いつ/どのような情報ログが存在するかを示す鍵 |
| プラットフォーム \| ビジネス | ✅ 関連ドキュメントを検索して見つけることができる |
| プラットフォーム \| 組織 | ✅ コードと宣言型カスタマイズには明確な説明がある |
---
### Design Standards Anti-Pattern (設計標準アンチパターン)
適切に設計された \[[容易](/docs/architect/ja-jp/well-architected/guide/easy-overview)] → \[[意図的]](/docs/architect/ja-jp/well-architected/guide/intentional) → \[[読みやすさ](/docs/architect/ja-jp/well-architected/guide/intentional#読みやすさ)] → \[[設計標準]](/docs/architect/ja-jp/well-architected/guide/intentional#設計標準) についての詳細
| Where to look?
商品領域 \| ロケーション | What to avoid?
アンチパターン |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Einstein \| プロンプトテンプレート | ⚠️ プロンプトテンプレートで専門用語や専門用語が使用されている プロンプトテンプレートには、簡潔な自然言語ではなく専門用語、略語、専門用語が含まれている |
| プラットフォーム \| ビジネス | ⚠️ 承認された AI モデルが明確に識別されておらず、その使用目的が明確でない |
| プラットフォーム \| ビジネス | ⚠️ チームは多くの異なるツールを使用して同様の作業を実行する |
| プラットフォーム \| ビジネス | ⚠️ 承認されたデザインパターンがない |
| プラットフォーム \| ビジネス | ⚠️ ベンダーや新入社員のオンボーディングに時間がかかる |
| プラットフォーム \| 組織 | ⚠️ コードと宣言型カスタマイズの名前が統一されていない |
| プラットフォーム \| 組織 | ⚠️ データモデルの名前に一貫性がなく、多くのオブジェクトと項目が冗長であるように見える |
| プラットフォーム \| 組織 | ⚠️ 監査では、使用されていない項目やさまざまなレベルの利用状況が表示され、レポートなどへのリンクが一貫していない。 |
### ドキュメントのアンチパターン
適切に設計された [容易](/docs/architect/ja-jp/well-architected/guide/easy-overview) → [意図的](/docs/architect/ja-jp/well-architected/guide/intentional) → [読みやすさ](/docs/architect/ja-jp/well-architected/guide/intentional#読みやすさ) → [ドキュメント](/docs/architect/ja-jp/well-architected/guide/intentional#ドキュメント)
| Where to look?
商品領域 \| ロケーション | What to avoid?
アンチパターン |
| ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Data 360 \| 組織 | ⚠️ ソースからターゲットへの対応付けは、データマッピングキャンバスでのみ文書化されます。データソース項目は、Data 360 のデータマッピングキャンバスでの設定時にデータモデルオブジェクト項目にその場で対応付けられます。 |
| プラットフォーム \| ビジネス | ⚠️ ソリューションの内容/方法/理由を見つけるのが難しく、ほとんどのチームが使用できない可能性がある |
| プラットフォーム \| ビジネス | ⚠️ 使用しているソリューションやシステムを理解するのに苦労している |
| プラットフォーム \| ビジネス | ⚠️ ベンダーや新入社員のオンボーディングに時間がかかる |
| プラットフォーム \| 組織 | ⚠️ コードおよび宣言型カスタマイズに説明がない、説明がわかりづらい、またはカスタマイズが実際に行っていることと一致しないように見える |
---