applying-cms-brand

CMS ブランドの適用

生成するコンテンツを検索、抽出し、CMS のブランドガイドラインに沿って適用するための汎用スキルです。

対象範囲

このスキルは、Salesforce CMS に保存されている既存のブランドガイドラインを、生成するコンテンツに適用するためのものです。

ユーザーが次のことを希望する場合に、このスキルを使用します。

• 生成コンテンツに自社のブランドボイスやトーンを適用する
• Salesforce CMS に保存されているブランドガイドラインを見つけて使用する
• 組織内の既存ブランドを検索する
• コンテンツ生成のためのブランド指示を取得する
• 生成コンテンツを自社のブランドアイデンティティに合わせる
• ページ、コンポーネント、アプリにブランドのスタイル、トーン、ボイスを適用する

ユーザーが次のことを希望する場合は、このスキルを使用しないでください。

• 画像やメディアを検索する（searching-media スキルを使用してください）
• ブランドをゼロから作成する
• CMS のブランド定義を編集する
• ロゴやビジュアルブランドアセットを生成する

開始する前に

重要：ブランドを生成または変更する前に、必ずブランド指示を取得してください。

ユーザーがブランドに沿ったコンテンツをリクエストした場合：

1. 利用可能なブランドを検索します（ブランドがまだ特定されていない場合）
2. 選択したブランドのブランド指示を抽出します
3. 生成するすべてのコンテンツにブランドガイドラインを適用します

先にコンテンツを生成して、後からブランドに合わせて修正することは避けてください。 コンテンツ生成の最初から、ブランド指示に従う必要があります。

ワークフローの概要

このチェックリストをコピーして、進捗を記録してください。

CMS Branding Progress:
- [ ] Step 1: Determine if brand is already identified or needs search
- [ ] Step 2: Search for brands (if needed) and present options to user
- [ ] Step 3: Extract brand instructions for the selected brand

ステップ 1：ブランドのコンテキストを確認する

ユーザーが使用するブランドをすでに指定しているか確認します。

ブランドが特定されている（ユーザーがブランド名を指定した、またはブランドが 1 つしかない）場合：

• ステップ 3（ブランド指示の抽出）に進みます

ブランドが特定されていない（ユーザーがブランドを指定せず、「自社ブランドを適用して」と依頼している）場合：

• ステップ 2（ブランドの検索）に進みます

ステップ 2：ブランドを検索する

ツール： search_brands

手順：

1. 検索クエリを決めます — ユーザーの説明、会社名、または一般的なキーワードを使用します
2. リクエストを作成します：

{
  "inputs": [{
    "searchQuery": "keyword or brand name"
  }]
}

3. クエリを指定して search_brands を呼び出します
4. レスポンスを解析します — ブランドの検索結果を抽出します：
   • managedContentId — 一意の ID（ステップ 3 での抽出に使用します）
   • managedContentKey — コンテンツキー識別子
   • title — ブランドの表示名
   • contentUrl — ブランドコンテンツの URL
   • totalResults — 見つかったブランドの数

ブランド検索結果の提示

複数のブランドが見つかった場合は、ask_followup_question を使用して選択肢を提示します。

I found [N] brands in your CMS. Which one should I apply?

1. [Brand Title 1]
2. [Brand Title 2]
3. [Brand Title 3]

Which brand would you like to use?

ブランドが 1 つ見つかった場合は、ユーザーに確認します。

I found the brand "[Brand Title]". Should I apply this brand's guidelines to the content?

ブランドが見つからなかった場合：

No brands found in Salesforce CMS. To use branding:
1. Create a brand in Salesforce CMS (Content Type: sfdc_cms__brand)
2. Provide brand guidelines directly in this conversation

Would you like to proceed without CMS branding, or provide guidelines manually?

ユーザーの確認なしにブランドを自動選択しないでください。 必ずユーザーの選択を待ちます。

ステップ 3：ブランド指示を抽出する

ツール： get_brand_instructions

手順：

1. get_brand_instructions を呼び出します — ブランド指示を抽出するためのプロンプトテンプレートを取得します

2. レスポンスを解析します：

   • promptBody — 抽出と適用に関するルールを含む、ブランド指示の完全なプロンプト

3. promptBody 内の指示に従います — プロンプトテンプレートには、次の具体的なガイダンスが含まれています：

   • ブランドコンテンツからブランド属性を抽出する方法
   • ブランドボイスとトーンのルール
   • タイポグラフィと色のガイドライン
   • コンテンツの書式設定ルール
   • ガードレールと制限事項

ブランド指示に含まれる内容

抽出されたブランド指示には、通常、次の内容が含まれています。

属性	説明
ブランドボイス	ブランドがどのように語りかけるか（例：プロフェッショナル、親しみやすい、権威ある）
ブランドトーン	コミュニケーションの感情的な質（例：自信に満ちた、温かみのある、共感的な）
主要メッセージ	中核となるメッセージの柱と価値提案
コンテンツルール	コンテンツ生成で行うべきこと、避けるべきこと
スタイルガイドライン	タイポグラフィ、色、間隔に関する設定
ガードレール	言葉遣い、トピック、主張に関する厳格な制限

エラー処理

エラー	応答
search_brands が利用できない	「ブランド検索を利用できません。ブランド名またはガイドラインを直接指定してください。」
get_brand_instructions が利用できない	「ブランドの指示を取得できません。この会話でブランドガイドラインを共有してください。手動で適用します。」
組織で Vibes のブランディングが有効になっていない	「この組織では CMS のブランディングが有効になっていません。Agentforce Vibes のブランディング機能を有効にするには、管理者にお問い合わせください。」
アクセス許可がない	「CMS のブランドにアクセスする権限がありません。Managed Content Authoring の権限があることを確認してください。」
ブランド情報の抽出結果が空	「ブランドは存在しますが、設定済みのガイドラインがありません。CMS にブランドプロパティを追加するか、ここでガイドラインを指定してください。」

決して黙って失敗しないでください。 必ずユーザーに知らせ、代替手段を提示してください。

主な原則

1. コンテンツよりブランドを優先する — コンテンツを生成する前に、必ずブランドの指示を取得してください
2. ブランドガイドラインを推測しない — CMS から明示的に取得した内容のみを適用してください
3. ガードレールを必ず守る — ブランドコンテンツのルールは提案ではなく、厳守すべき制約です
4. ブランドの選択を確認する — ユーザーの確認なしにブランドを自動選択しないでください
5. 作業内容を明示する — 適用したガイドラインとその適用方法をユーザーに伝えてください
6. 利用できない場合も適切に対応する — ツールを利用できない場合は、ブランディングなしで進めるのではなく、手動でガイドラインを指定するよう依頼してください