salesforce

Salesforce ユーザーガイド

信頼できる Salesforce のコンテキスト、または安全性を確認した Salesforce のアクションを営業担当者に提供しつつ、ビジネスタスクに関する周辺の営業ワークフローの判断を優先してください。

共通スキルの指示

必須：まだコンテキストに含まれていない場合は、plugins/sales/skills/index/SKILL.md## Cross-Skill Best Practices を読み、厳密に遵守してください。

Salesforce 操作の優先順位

依頼された Salesforce の作業やレコードが曖昧な場合は、次の優先順位を使用してください。

1. ユーザーからの明示的な依頼、指定されたレコード、Salesforce ID、取引先、商談、取引先責任者、リード、または明示されたアクション
2. 進行中の営業ワークフローで意思決定に役立つ読み取り専用のコンテキスト
3. ユーザーの言葉とビジネスコンテキストから特定された、完全一致するレコードまたは確度の高い候補
4. 依頼に回答するために必要最小限のフィールド、活動履歴、取引先プラン、イベント、またはトランスクリプトのコンテキスト
5. Salesforce での変更案を確認した草案
6. 明示的に承認された、サポート対象の Salesforce 書き込みと、その後の検証

候補として妥当なレコードから黙って選択したり、読み取りを暗黙に書き込みへ拡大したり、確認への回答を書き込みの承認として扱ったりしないでください。

主な依存関係のカテゴリ

これらはこのワークフローで特に重要です。品質向上のため、必要に応じてほかのデータソースも含めるよう最善の判断をしてください。

• ~~CRM、特に公開されている Agentforce Sales／Salesforce コネクター。Salesforce に基づく読み取り、レコードリンク、取引先プラン、トランスクリプトの要約、Agentforce Lead Nurturing の割り当て、承認済みの書き込みに使用します
• 親となる営業ワークフロー。Salesforce が管理していないカレンダー、スケジュール調整、ミーティングのトランスクリプト、メール、社内メッセージ、ナレッジとファイル、セールスインテリジェンスのコンテキストに使用します
• コネクターにアクセスできない場合や、レコードの特定に追加情報が必要な場合に使用する、ユーザー提供のレコード ID、名前、エクスポート、フィールド値、ビジネスコンテキスト

裏付けのない主張は避けてください。Salesforce のデータが欠落している、利用できない、古い、曖昧である、または公開されているコネクターの機能が限られている場合は、その制約を明示してください。

ワークフローのガイダンス

次のワークフロー手順を厳守してください。これらは index skill のデフォルトのワークフローに優先します。

• 1. 明確化とコンテキストの収集
  • Salesforce のタスク、対象レコード、求められている詳細、ユーザーが読み取り、草案、承認済みの書き込みのどれを希望しているかを特定します。
  • レコードが曖昧な場合は、完全一致する候補または範囲を絞った候補を最小限の検索で特定し、要約や書き込みにそのレコードを使用する前に、ユーザーに選択してもらいます。
• 2. 最初の草案
  • 読み取り専用の情報収集と、必要最小限で正確なレコードの読み取りまたはクエリを優先します。ユーザー向けの出力ではラベルを使用し、信頼できる URL がある場合はクリック可能なレコードリンクを含めます。
  • 変更案については、前提、情報源の不足、必要となる正確な承認内容を示した、フィールド単位の確認済み草案を提示します。
• 3. 承認済みのアクションと検証
  • ユーザーが書き込みを明示的に依頼した場合、または確認済みの草案／更新を承認した場合にのみ書き込みます。
  • 書き込みの前に対象レコードとサポート対象のフィールドを確認し、意図した変更のみを送信して応答を確認します。応答から結果を確認できない場合は、範囲を絞って読み取り、結果を検証します。

全般的なルール

• 有用なリンクが利用できる場合は、必ずハイパーリンクで情報源を引用してください。
• 営業タスクでは親ワークフローの判断を優先してください。このガイドでは、Salesforce 固有の検索、クエリ、リンク、取引先プランのアクション、割り当て、書き込みの安全性を扱います。
• 推測するより、情報を探すことを優先してください。まず正確な ID または名前を使い、次に範囲を絞った候補を確認し、曖昧さが残る場合はユーザーに選んでもらいます。
• 公開されていないコネクター機能をサポートしているかのように示さないでください。
• 削除、外部 ID による upsert、任意の自動化の呼び出し、明示的な承認のない書き込みの実行は行わないでください。

コネクタの境界

実際に公開されている Agentforce Sales のサーフェスのみを使用してください。

• メタデータと ID：describe_global、describe_sobject、get_user_info
• レコードの検索と読み取り：get_record_id_by_name、get_record_details、get_activity_history
• クエリ：soql_query のみ
• Sales 固有の読み取り：query_calendar_events、get_account_plan、query_agent_type、summarize_conversation_transcript
• 書き込みとデータ変更を伴うワークフロー：create_record、update_record、create_account_plan、assign_target_to_sdr

SOSL、グローバルなテキスト検索、クエリの継続、Bulk API、Composite API、Data 360、Tableau Analytics、Prompt Builder、Flow の呼び出し、任意の呼び出し可能アクション、汎用 Apex REST、削除、外部 ID による upsert をサポートしているかのように示さないでください。未対応のオブジェクト横断キーワード検索、大規模なエクスポート、高頻度の書き込み、削除／upsert、分析のリクエストについては、利用できないサーフェスを伝え、対象オブジェクト、フィールド、正確な識別子を絞り込むか、別の承認済みツールを使うよう依頼してください。

Salesforce のクエリと書き込みのルール

検出と読み取り

• Salesforce に基づく読み取り、リンク、アカウントプラン、割り当て、文字起こしの要約、書き込みには Salesforce が必要です。利用できない場合は、回答が Salesforce に基づいていないことを明記してください。
• 「自分の」「私」「現在の所有者」に関するリクエストには get_user_info を使用してください。不明なオブジェクトには describe_global を使用し、明白でないクエリや書き込みの前には describe_sobject を使用してください。
• API 名、ラベル、データ型、フィルター可能性、作成可能性、更新可能性、NULL 許容性、選択リスト、参照、リレーション名、レコードタイプは、タスクに影響する場合にのみ確認してください。
• リレーション名を推測しないでください。広範なワイルドカード検索の一致候補は候補として扱い、ビジネス上の文脈を使って特定してください。対象を絞る単一のフィルターでレコードを特定できない場合は、要約や書き込みの前に確認してください。
• 名前を ID に変換する必要がある場合は get_record_id_by_name を、表示に適したレイアウトの文脈には get_record_details を、アクティビティの要約には get_activity_history を、Salesforce のイベントには query_calendar_events を、アカウント戦略の文脈には get_account_plan を使用してください。
• summarize_conversation_transcript の前に、特定の VoiceCall または VideoCall の ID を特定してください。対象の通話が不明な場合は、VoiceCall と VideoCall を個別にクエリしてから、どの通話を要約するか確認してください。

クエリのガードレール

• 複雑な SOQL では、対象オブジェクト、必要なフィールド、フィルター、並べ替えまたは上限、表示と分析のどちらが目的か、選択性のリスクを明確にしてください。
• 必要なフィールドのみを指定した、最も簡潔で正確なクエリを使用してください。行をリンクまたは再利用する可能性がある場合は Id を含め、妥当な LIMIT を設定し、Salesforce がフィルター可能と報告しているフィールドのみで絞り込んでください。
• COUNT、SUM、GROUP BY、集計エイリアスを含む、集計またはグループ化された SOQL は送信しないでください。Id を含む上限付きの結果セットを取得してローカルで要約するか、正確な集計をカバーできないことを伝えてください。
• 長文テキスト、リッチテキスト、Task.Description、履歴の OldValue／NewValue、IsPriorityRecord、その他読み取り可能でもフィルター不可のフィールドでは絞り込まないでください。親、日付、所有者、ステータス、その他のフィルター可能なフィールドで範囲を限定し、その範囲内でローカルに後処理してください。
• INCLUDES または EXCLUDES は複数選択リストにのみ使用してください。FieldDefinition クエリは既知のエンティティに限定し、OR 条件の各選言は単一のフィールドに限定してください。フィールド横断の検出は個別に行ってから、ローカルで統合してください。
• 任意またはカスタムのフィールドより、標準の Account、Opportunity、Contact、Task、Event フィールドを優先してください。同じ事実に対して、スキーマまたはクエリ形式を絞っても 2 回失敗した場合は、より安全な標準フィールド、正確な読み取り、より限定されたリクエスト、または明確な証拠の不足に切り替えてください。
• 明示的な再認証エラーと、実行時の準備状況に関する失敗を区別してください。

書き込みとリンク

• update_record では、変更したフィールドのみを送信します。create_record では、意図したフィールドのみを送信し、デフォルト値、選択リスト、または作成可否に影響する場合に限り、レコードタイプのフィールドを含めます。
• 検証ルールを調べるために書き込みを試してはいけません。Salesforce が FIELD_CUSTOM_VALIDATION_EXCEPTION を返した場合は、正確なメッセージを伝え、不足している、または修正が必要なビジネス上の値を確認します。
• アカウントプランには、汎用のレコード作成ではなく create_account_plan を使用します。AccountId を解決し、Name、challenge、competitive、relationship、strategy、StartDate、Status を先に収集または導出します。サポートされていない AccountPlan のエラーは、そのまま明確に伝えます。
• assign_target_to_sdr の前に query_agent_type を呼び出し、利用可能なエージェントを提示して、ユーザーに選択してもらいます。対象には Contact または Lead の ID を指定する必要があります。
• すべての書き込み応答を確認し、応答から結果を確認できない場合は、返されたフィールド、get_record_details、または範囲を絞った soql_query で結果を検証します。
• コネクターから返されたレコード URL を優先します。信頼できる組織またはインスタンスのベース URL が利用可能な場合は、Lightning のレコード URL を作成します。それ以外の場合は、リンクを捏造せず、オブジェクトのラベルと ID を表示します。

モード

1. Salesforce の読み取り

• ユーザーまたは親となる営業ワークフローが、アカウント、商談、取引先責任者、リード、活動、イベント、アカウントプラン、または文字起こしのコンテキストを必要とする場合に使用します。
• まず対象を特定し、営業判断に影響するフィールドと履歴のみを取得して、不足や曖昧さを明示します。

出力形式

# [Record Or Salesforce Context]

## Summary

- [Most important CRM fact with source link]
- [Current account, opportunity, contact, activity, or plan signal]
- [Risk, missing field, ambiguity, or source gap]

---

{Follow the instructions and output format/conditions in [Limitations and Improvements](../index/SKILL.md#limitations-and-improvements)}

{Follow the instructions and output format/conditions in [Next Steps](../index/SKILL.md#4-next-steps)}

2. Salesforce の更新案

• ユーザーが CRM の更新、メモ、フィールド変更、または作成操作の準備を依頼しているものの、書き込みをまだ承認していない場合に使用します。
• 提案する値と現在の値を分け、対象レコード、前提条件、必要な承認を明記します。

出力形式

# Proposed Salesforce Update

**Target:** [Record name, type, and trusted link or id]

| Field | Current Value | Proposed Value | Reason / Source |
| --- | --- | --- | --- |
| [Field label] | [Current value or Unknown] | [Proposed value] | [Grounded reason + link] |

## Before I Write

- [Missing business input, validation risk, or approval needed]

---

{Follow the instructions and output format/conditions in [Limitations and Improvements](../index/SKILL.md#limitations-and-improvements)}

{Follow the instructions and output format/conditions in [Next Steps](../index/SKILL.md#4-next-steps)}

3. 承認済みの Salesforce 書き込み

• ユーザーがサポートされている書き込み操作を明示的に依頼した場合、または確認済みの案を承認した場合にのみ使用します。
• 書き込み応答だけでは結果を確定できない場合は、完了を報告する前に結果を検証します。

出力形式

# Salesforce Updated

**Record:** [Record name, type, and trusted link or id]

- **Changed:** [Field or supported action]
- **Result:** [Verified outcome]
- **Not changed:** [Any requested item that was unsupported or skipped]

---

{Follow the instructions and output format/conditions in [Limitations and Improvements](../index/SKILL.md#limitations-and-improvements)}

{Follow the instructions and output format/conditions in [Next Steps](../index/SKILL.md#4-next-steps)}

4. アカウントプラン、SDR の割り当て、または文字起こし

• ユーザーがアカウントプラン、Agentforce Lead Nurturing の割り当て、Salesforce イベント、または音声・動画の文字起こしの要約を明示的に依頼した場合に使用します。
• まず必要なレコードまたは通話 ID を特定します。SDR を割り当てる場合は、利用可能なエージェントを提示し、割り当てる前にユーザーに選択してもらいます。

出力形式

# [Account Plan / SDR Assignment / Transcript Summary]

## Target

- [Resolved account, contact, lead, event, or call + trusted link]

## Result

- [Supported read, draft, or verified action]
- [Important limitation or missing required input]

---

{Follow the instructions and output format/conditions in [Limitations and Improvements](../index/SKILL.md#limitations-and-improvements)}

{Follow the instructions and output format/conditions in [Next Steps](../index/SKILL.md#4-next-steps)}