Agentforce (Salesforce)

一個與Salesforce Agentforce API交互的MCP服務器，提供認證、會話管理和消息傳遞功能。

客戶支持開發者工具 #Salesforce集成 #會話管理 #消息傳遞 #API代理 .Python

評分 : 2.5分

下載量 : 8.9K

更新時間 : 2025-04-28

打開站點

什麼是Agentforce MCP服務器？

Agentforce MCP服務器是一款專為與Salesforce Agentforce API集成而設計的工具。它允許您通過簡單的設置流程實現身份驗證、創建會話併發送消息給Agentforce代理。

如何使用Agentforce MCP服務器？

只需幾個簡單的步驟即可完成安裝和配置。您可以使用我們的交互式腳本快速啟動服務器，或者手動設置環境變量並運行腳本。

適用場景

Agentforce MCP服務器非常適合需要即時與Salesforce代理通信的企業客戶，例如客服中心或技術支持團隊。

主要功能

身份驗證

使用客戶端郵箱進行身份驗證，確保您的賬戶安全。

創建會話

為指定的代理創建一個新會話，並管理其狀態。

發送消息

向代理發送自定義消息，並接收他們的回覆。

獲取會話狀態

檢查當前會話的狀態，包括身份驗證狀態、會話ID和序列ID。

完整對話流程

自動執行身份驗證、會話創建和消息發送的整個流程。

優勢

易於使用且無需複雜配置

支持多客戶端併發處理

全面的日誌記錄便於調試

侷限性

需要穩定的網絡連接

對Salesforce權限設置有一定依賴

如何使用

安裝依賴

首先確保已安裝Python 3.10及以上版本，並通過pip安裝所需的依賴項。

配置環境變量

複製.env.example文件為.env，並填寫您的Salesforce憑據。

運行服務器

賦予腳本執行權限後，直接運行server腳本。

使用案例

身份驗證測試

嘗試使用特定客戶端郵箱進行身份驗證。

發送消息到代理

向代理發送一條問候消息並等待響應。

常見問題

如何找到我的Salesforce Org ID？

如果遇到身份驗證失敗怎麼辦？

服務器支持哪些操作系統？

🚀 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交互，方便調試。

📦 安裝指南

環境變量配置

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

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

下載與依賴安裝

下載源碼：

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

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

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

依賴安裝：

mvn clean install

💻 使用示例

基礎用法

使用github_push.sh腳本

該腳本幫助將本地倉庫推送到GitHub，特別適合新項目初始化。

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

賦予執行權限並運行：

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

使用管理員賬戶登錄Salesforce組織
進入設置
在快速搜索欄中輸入"App Manager"並點擊進入
點擊新建連接應用
填寫基本信息：
- 應用程序名稱：例如 "Agentforce MCP集成"
- API名稱：將自動填充
- 聯繫郵箱：填寫您的郵箱地址
啟用OAuth設置選項
設置回調URL為https://localhost/oauth/callback
在選擇的OAuth範圍中，添加：
- 管理用戶數據（api）
- 任何時間執行請求（refresh_token, offline_access）
點擊保存
在連接應用詳情頁面記錄消費者密鑰(Client ID)
點擊顯示旁邊的消費者秘密(Consumer Secret)以獲取客戶端密碼

獲取代理ID

登錄Salesforce組織
導航至Einstein Agent Builder
選擇要使用的代理
查看瀏覽器地址欄中的URL，格式為https://your-salesforce-instance.lightning.force.com/lightning/r/Agent__c/0XxXXXXXXXXXXXXX/view
提取18位字符ID（如 0XxXXXXXXXXXXXXX）作為代理ID

獲取Salesforce My Domain URL

登錄Salesforce組織
進入設置
在快速搜索欄中輸入"My Domain"並點擊進入
查看顯示的域名格式為DOMAIN-NAME.my.salesforce.com
將此URL（不帶"https://”前綴）用於.env文件

獲取組織ID

登錄Salesforce組織
進入設置
在快速搜索欄中輸入"公司信息"並點擊進入
查看"組織ID"字段，這是您的 Salesforce 組織ID
它將是一個15或18位的字符編碼

🔧 技術細節

服務器管理

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

GitHub推送腳本

該腳本將執行以下操作：

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

📄 許可證

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

⚠️ 注意事項

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

💡 使用建議

故障排除

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

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