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代理服务器。