Agentforce (Salesforce)

🚀 Agentforce代理サーバーガイド

このガイドでは、Agentforce代理サーバーの設定、操作、およびトラブルシューティングに関する詳細な手順を提供します。

🚀 クイックスタート

環境変数の設定

環境変数を設定するには、以下の手順に従ってください。

1. ターミナルを開きます。
2. 次のコマンドを実行します。

source ~/.bash_profile

GitHubへの変更のプッシュ

GitHubへの変更のプッシュを簡素化するために、便利なスクリプトを提供しています。以下の手順で操作してください。

1. スクリプトに実行権限を付与します。

chmod +x github_push.sh

2. スクリプトを実行します。

./github_push.sh

このスクリプトは以下の操作を実行します。

• システムにGitがインストールされているかを確認します。
• 敏感なファイル（例：.env）がGitHubにプッシュされないようにします（これらのファイルは.gitignoreに追加されています）。
• ユーザーにGitHubリポジトリのURLの入力を求めます。
• Gitリポジトリを初期化するか、リモートリポジトリのURLを更新します。
• コミットするファイルを表示し、ユーザーに確認を求めます。
• コミットメッセージを自動生成し、変更をプッシュします。

✨ 主な機能

Connected Appの作成

1. 管理者アカウントでSalesforce組織にログインします。
2. 設定にアクセスします。
3. クイック検索バーに「App Manager」と入力し、クリックして移動します。
4. 新しい接続アプリをクリックします。
5. 基本情報を入力します。
   • アプリケーション名：例えば「Agentforce MCP統合」
   • API名：自動的に入力されます。
   • 連絡先メールアドレス：あなたのメールアドレスを入力します。
6. OAuth設定オプションを有効にします。
7. コールバックURLをhttps://localhost/oauth/callbackに設定します。
8. 選択したOAuthスコープに以下を追加します。
   • ユーザーデータの管理（api）
   • いつでもリクエストを実行する（refresh_token, offline_access）
9. 保存をクリックします。
10. 接続アプリの詳細ページでコンシューマーキー(Client ID)を記録します。
11. コンシューマーシークレット(Consumer Secret)の隣の表示をクリックして、クライアントパスワードを取得します。

代理IDの取得

1. Salesforce組織にログインします。
2. Einstein Agent Builderに移動します。
3. 使用するエージェントを選択します。
4. ブラウザのアドレスバーのURLを確認します。形式はhttps://your-salesforce-instance.lightning.force.com/lightning/r/Agent__c/0XxXXXXXXXXXXXXX/viewです。
5. 18文字のID（例：0XxXXXXXXXXXXXXX）を抽出して、代理IDとして使用します。

Salesforce My Domain URLの取得

1. Salesforce組織にログインします。
2. 設定にアクセスします。
3. クイック検索バーに「My Domain」と入力し、クリックして移動します。
4. 表示されるドメイン名（DOMAIN-NAME.my.salesforce.com形式）を確認します。
5. このURL（「https://」プレフィックスを除く）を.envファイルに使用します。

組織IDの取得

1. Salesforce組織にログインします。
2. 設定にアクセスします。
3. クイック検索バーに「会社情報」と入力し、クリックして移動します。
4. 「組織ID」フィールドを確認します。これがあなたのSalesforce組織IDです。
5. これは15または18文字のコードになります。

📦 インストール

ソースコードのダウンロード

git clone https://github.com/agentforce/server.git
cd server

環境変数の設定

~/.bash_profileファイルを編集し、以下の内容を追加します。

export AGENTFORCE_HOME=$(pwd)
source ~/.bash_profile

依存関係のインストール

プロジェクトディレクトリに移動してから、次のコマンドを実行します。

mvn clean install

💻 使用例

基本的な使用法

サーバーの起動

cd $AGENTFORCE_HOME/bin
./start.sh

サーバーの停止

cd $AGENTFORCE_HOME/bin
./stop.sh

高度な使用法

github_push.shスクリプトの使用

このスクリプトは、ローカルリポジトリをGitHubにプッシュするのに役立ち、特に新しいプロジェクトの初期化に適しています。

操作手順

1. スクリプトをプロジェクトのルートディレクトリに追加します。

wget https://raw.githubusercontent.com/agentforce/server/master/bin/github_push.sh

2. 実行権限を付与してスクリプトを実行します。

chmod +x github_push.sh
./github_push.sh

パラメータの説明

• このスクリプトには追加のパラメータは必要ありません。Gitの設定を自動的に検出します。
• リポジトリのURLの入力を求められたら、自動的にプッシュを完了します。

📚 ドキュメント

よくある質問

Q: SSH接続の問題はどう処理すればいいですか？

A: ローカルでSSHキーが生成されていることを確認し、GitHubのSSH Keys設定に追加してください。次のコマンドを実行してテストしてください。

ssh -T git@github.com

Q: プッシュが失敗した場合はどうすればいいですか？

A: ネットワーク接続を確認し、リポジトリのURLが正しいことを確認してから、スクリプトを再実行してください。

完全な例

# ソースコードのダウンロード
git clone https://github.com/agentforce/server.git
cd server

# 環境変数の設定
echo 'export AGENTFORCE_HOME=$(pwd)' >> ~/.bash_profile
source ~/.bash_profile

# 依存関係のインストール
mvn clean install

# サーバーの起動
cd $AGENTFORCE_HOME/bin
./start.sh

上記のコマンドを実行すると、Agentforce代理サーバーが正常にデプロイされ、起動します。

🔧 技術詳細

注意事項

• サーバーはメッセージ交換のシーケンス番号を自動的に管理します。
• 各メールアドレスは認証とセッション状態を維持します。
• すべてのAPIのやり取りはデバッグ用に記録されます。

トラブルシューティング

問題が発生した場合は、以下を確認してください。

• 認証失敗：接続アプリの設定が正しいことを確認してください。
• 代理IDの取得エラー：Einstein Agent BuilderのURLを確認してください。
• 組織IDのエラー：会社情報ページで確認してください。
• コールバックURLの問題：正しいローカルコールバックアドレスが設定されていることを確認してください。