Salesforce の API、CLI、スキルについて学習する
学習の目的
この単元を完了すると、次のことができるようになります。
- API ファーストアプローチの理由を説明する。
- CLI とエージェンティックスキルサポートについて説明する。
API ファーストアプローチ
ヘッドレスアーキテクチャは、API ファーストアプローチを基盤として構築されています。API ファーストアプローチとは、Salesforce が各機能に対して堅牢なアプリケーションプログラミングインターフェイス (API) を設計、構築、公開するという考え方です。API ファーストアプローチの主な原則は次のとおりです。
- 疎結合アーキテクチャ: ロジックとデータが画面のビジュアルデザインから切り離されており、ユーザーに高い柔軟性を提供します。
- 実行基盤: CRM は、人間と AI エージェントの両方のインタラクションに対応するバックエンドエンジンとして機能します。
- エージェンティック対応: クリーンで決定論的なエンドポイントにより、自動化された AI エージェントがブラウザーを必要とせずにタスクを実行できます。
- 開発者の柔軟性: チームは同一の基盤となる機能を使用して、構成可能な独自のフロントエンドを構築できます。
Salesforce は、データ操作 (REST/SOAP/一括)、メタデータ管理 (Metadata API)、リアルタイムイベント、最新パターン (GraphQL、名前付きクエリ) をカバーする専門的な API を提供しています。インテグレーションパターンとデータ量のニーズに基づいて、API の種別を選択してください。
Salesforce 開発者ポータルには、コードサンプル、レート制限、バージョン情報を含む包括的なリファレンスが掲載されています。Salesforce は、事前設定済みの認証とサンプル要求を含む公式 Postman コレクションを提供しています。これにより、コードを書かずに API の探索とテストを迅速に行えます。
API は製品別にも分類されています。たとえば、Connect REST API は Salesforce 検索、B2B Commerce、Experience Cloud へのプログラムによるアクセスを提供します。
Salesforce は、すべての機能において完全で使いやすい API サーフェスの提供を優先しており、ユーザーインターフェースに依存しないエラーメッセージをエージェントが活用できるよう提供し、包括的なリファレンスドキュメントを整備し、これらのツールを通じてあらゆるインターフェースへの接続を可能にしています。
Salesforce コマンドラインインターフェース
Salesforce CLI は、任意のターミナルや IDE から Salesforce 組織を操作するための主要なコマンドラインインターフェースです。組織の作成、メタデータの展開と取得、Apex の実行、データのクエリ、認証の管理、CI/CD ワークフローのスクリプト作成などに使用できます。
堅牢でスクリプト実行可能な CLI は、開発者、アーキテクト、システム管理者がブラウザーを使わずに Salesforce にアクセスするためのもう 1 つの重要なツールです。Salesforce CLI は、Node.js でコマンドラインインターフェースを構築するためのオープンソースフレームワークである oclif をベースにしています。Agentforce Vibes、Claude、または Cursor から CLI にアクセスできます。
たとえば、Agentforce Vibes に SF CLI をインストールするには、Salesforce CLI 拡張がリストに表示されているかどうかを確認します。次のコマンドを使用して、最新バージョンの Salesforce CLI 実行可能ファイルをインストールします。
npm install --global @salesforce/cli
実行可能ファイルである sf は、Salesforce CLI 拡張にバンドルされています。拡張をインストールしたら、Agentforce Vibes のインターフェースで次のコマンドを実行して、SF CLI のバージョンとサポートされているコマンドのリストを確認します。
sf --version sf --help sf commands
これで Salesforce での作業を開始できます。たとえば、接続している組織のリストと特定の組織で有効なメタデータ型を表示するには、次のコマンドを実行します。
sf org list sf org list metadata-types --api-version 57.0 --target-org my-dev-org
スキルとは?
スキルとは、Claude や Cursor などの AI アシスタントから呼び出すことができる専門的な機能です。スキルは、分野の専門知識を備えた事前構築済みのワークフローであり、自然言語クエリでできることを拡張します。スキルは「/スキル名」という標準的な方法で呼び出され、コンテキストを認識します。スキルは専門知識を活用し、構成可能です。
スキルは、よく使われる複数ステップのワークフローを 1 つのコマンドに変換します。たとえば、「ファイルを読み込み、分析して、レポートを作成する」という操作の代わりに、「/code-review」と入力するだけで済みます。AI アシスタントが自動的に作業ディレクトリ内の変更されたファイルを特定し、セキュリティと品質の指針に基づいて変更を分析し、テストカバー率を評価して、推奨事項を含むレポートを生成します。これらすべては、分野の専門知識が組み込まれた状態で実行されます。そのため、すべてのレビュー基準を覚えたり、AI アシスタントを各ステップごとに誘導したりする必要はありません。
スキルは、認証アクセスを備えたリポジトリ内の個別ファイルとして配布することも、プラグインとしてまとめてグループ化することもできます。スキルディレクトリには、通常、次のファイルとディレクトリが含まれます。
- SKILL.md ファイル: エージェントがタスクを完了するためのスキル名、説明、および一連の手順が含まれます。
- 参照ファイル: AI エージェントのスキルを拡張する補足ドキュメントです。
- スクリプト: スキルディレクトリにバンドルされた実行可能なコードファイルで、特定の繰り返しタスクの自動化、出力の検証、またはデータ処理に使用されます。
- 評価: スキル評価の略称で、AI エージェントが指示やワークフローを正しくトリガーし、従い、実行するかどうかを測定するための体系的なテストです。
スキルディレクトリには SKILL.md ファイルが必須で、その他のファイルは省略可能です。
Salesforce は、Salesforce の開発および実装ワークフロー向けに、分野の専門知識を持つ、厳選されたエージェントスキルのコレクションに取り組んできました。最新のスキルセットについては、sf-skills GitHub リポジトリを参照してください。これらのスキルは、Agentforce Vibes によって自動的にインストールされ有効化されます。これらのスキルは、次のコマンドを使用して Claude や Cursor などの任意の AI インターフェースにインストールすることもできます。
npx skills add forcedotcom/sf-skills
Salesforce のエージェントスキルを使用してアプリケーションを構築できます。Salesforce スキルライブラリには、Lightning アプリケーション、Apex、フロー、Data 360 機能などのコンポーネント向けスキルが含まれています。これらのスキルは Agentforce Vibes 環境向けに最適化されていますが、任意の AI インターフェースで使用できます。
例として、Salesforce の Sandbox 環境の管理を支援する platform-sandbox-configure スキルを見てみましょう。このスキルを使用して、Sandbox の在庫一覧の表示、特定の Sandbox の状況の確認、新しい Sandbox の作成、および最新の本番データによる Sandbox の更新を行います。AI スキルとプラグインについての詳細は、『Salesforce Development Plugin for Claude Code (Claude Code 向け Salesforce 開発プラグイン)』を参照してください。
ツールの使い分け
各ツールにはそれぞれの利点とユースケースがあります。
- MCP は OAuth ベースのユニバーサルコネクタとして機能し、標準のセキュリティモデルに準拠したさまざまなサーバー種別を備えています。AI エージェントが Salesforce 組織に対して安全にアクションを実行できるようにするには、MCP サーバーとその標準機能を使用します。
- Salesforce の API ファーストアプローチは、堅牢で確定的なエンドポイントを公開し、AI エージェントがブラウザーなしでタスクを実行できるようにします。Salesforce とサードパーティシステムをプログラムで統合するには、API を使用します。
- Salesforce のスクリプト実行可能な CLI を使用することで、開発者、アーキテクト、システム管理者はターミナルや任意の AI インターフェースから Salesforce にアクセスできます。スクリプトによって開発タスクや展開タスクを自動化するには、CLI を使用します。
- スキルを使用することで、分野の専門知識を構成可能で再利用可能なコマンドにパッケージ化し、複雑なマルチステップのワークフローを単一のアクションに変換できます。AI エージェントに反復実行できるワークフローを提供し、専門知識を利用して一貫した出力を得るには、スキルを使用します。
まとめ
このモジュールでは、ヘッドレスツールがプラットフォームを特定の UI から切り離し、すべてのレイヤーを AI エージェント、モデル、サードパーティツールからアクセス可能にするしくみを学習しました。このアプローチを支える 4 つの主要テクノロジー、すなわち Model Context Protocol (MCP)、API、CLI、スキルについても学習しました。
これらの機能が組み合わさることで、Salesforce は完全にアクセス可能なエージェント対応プラットフォームになり、 お好みの AI インターフェースで、構築、統合、自動化を実現できます。
リソース
- Salesforce Developers: Salesforce API
- Salesforce Developers: Agentforce Vibes Developer Guide: Skills (Agentforce Vibes 開発者ガイド: スキル)
- Salesforce 開発者: Salesforce CLI Setup Guide (Salesforce CLI 設定ガイド)
- Salesforce Developers: Salesforce CLI Command Reference (Salesforce CLI コマンドリファレンス)
- Trailhead: Agentforce Vibes スキル: クイックルック