Agentforce (Salesforce)

🚀 Agentforce代理服務器指南

Agentforce代理服務器指南旨在幫助用戶完成環境變量配置、GitHub推送腳本使用、Salesforce相關信息獲取等操作，以順利部署和使用代理服務器。

🚀 快速開始

環境準備

• 操作系統：Linux/MacOS/Windows（推薦使用Linux或 MacOS）
• Java版本：JDK 8 或更高版本
• Git工具：建議安裝Git for Windows（若在Windows上）

下載源碼

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推送腳本，簡化操作流程。
• 自動管理消息交換的序列號，維護每個電子郵件地址的身份驗證和會話狀態。
• 記錄所有API交互，方便調試。

📦 安裝指南

環境變量配置

要配置環境變量，請按照以下步驟操作：

1. 打開終端
2. 運行命令：source ~/.bash_profile

下載與依賴安裝

1. 下載源碼：

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

2. 配置環境變量： 編輯~/.bash_profile文件，添加以下內容：

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

3. 依賴安裝：

mvn clean install

💻 使用示例

基礎用法

使用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

按照提示輸入GitHub倉庫URL後，腳本會自動處理其餘步驟。

高級用法

配置文件路徑示例

# 設置代理服務器路徑
export AGENTFORCE_HOME=/path/to/agentforce-server

# 設置運行環境
export ENV=development

# 啟動服務器
$AGENTFORCE_HOME/bin/start.sh

📚 詳細文檔

創建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位的字符編碼

🔧 技術細節

服務器管理

• 服務器自動管理消息交換的序列號。
• 每個電子郵件地址維護身份驗證和會話狀態。
• 所有API交互都會記錄以備調試使用。

GitHub推送腳本

該腳本將執行以下操作：

• 檢查系統是否已安裝Git
• 確保敏感文件（如.env）不會被推送到GitHub（這些文件已添加到.gitignore）
• 提示用戶輸入GitHub倉庫URL
• 初始化Git倉庫或更新遠程倉庫URL
• 顯示要提交的文件供用戶確認
• 自動生成提交消息並推送更改

📄 許可證

文檔中未提及相關許可證信息。

⚠️ 注意事項

• 服務器自動管理消息交換的序列號。
• 每個電子郵件地址維護身份驗證和會話狀態。
• 所有API交互都會記錄以備調試使用。

💡 使用建議

故障排除

遇到問題時，請檢查以下內容：

1. 認證失敗：確認連接應用設置無誤。
2. 代理ID獲取錯誤：檢查Einstein Agent Builder中的URL。
3. 組織ID錯誤：在公司信息頁面核對。
4. 回調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代理服務器。