使用说明
Salesforce人工智能代理(MCP+NVIDIA LLM)
一个强大的Salesforce中间件,使用 Nvidia火焰-3 通过以下方式智能查询和管理Salesforce数据 模型上下文协议(MCP).
🚀 特性
- 智能查询:自然语言到SOQL的转换。
- MCP本地:与Claude Desktop、Cursor和其他MCP客户端兼容。
- 自治代理:包括一个可以执行多步Salesforce任务的“大脑”循环。
🛠️ 设置
先决条件
- Node.js v18+
- Salesforce开发人员组织
- NVIDIA API密钥(来自NVIDIA API目录)
根目录
- mcp提供者api
✨ 特性
🔐 安全的Salesforce连接
📚 完整的组织架构发现
🔍 原始SOQL执行
✍️ 创建、更新和删除记录
🤖 自然语言→ 使用LLM的SOQL
🧠 智能查询(生成→ 执行→ 解释)
💬 带有可选模式上下文的聊天界面
🧱 技术栈
-
后端:Node.js(Express)
-
CRM:Salesforce REST API
-
AI:OpenAI/兼容LLM
-
身份验证:Salesforce OAuth 2.0
环境变量
创建一个 .env 在Render中文件或设置这些:
SALESFORCE_USERNAMESALESFORCE_PASSWORDSALESFORCE_SECURITY_TOKENNVIDIA_API_KEYSALESFORCE_LOGIN_URLSALESFORCE_ACCESS_TOKEN:如果面对访问SF组织SALESFORCE_INSTANCE_URLSCHEMA_CACHE_TTLENABLE_PERSISTENT_CACHE
📦 安装
npm install
npm start
启动命令
node http-server.js
构建Comand
npm install
🔌端点
- GET/健康
- GET/模式
- GET/schema/:对象名称
- POST/查询
- POST/创建
- POST/更新
- POST/删除
- POST/生成soql
- POST/智能查询
- POST/聊天
📌 API终点
| 终点 | 目的 |
|---|---|
| GET/health | 检查服务器和Salesforce连接状态 |
| GET/schema | 列出所有组织对象 |
| GET/schema/:objectName | 获取特定对象的字段 |
| POST/query | 执行原始SOQL |
| POST/create | 创建记录 |
| POST/更新 | 更新记录 |
| POST/delete | 删除记录 |
| POST/describe-object | 返回对象架构+示例数据 |
| POST/generate-soql | 使用LLM将自然语言转换为soql |
| POST/智能查询 | 生成SOQL执行→ 解释结果 |
| POST/chat | 具有可选模式上下文的聊天界面 |
2. .gitignore
防止私钥上传到GitHub至关重要。
依赖项
节点模块/ .npm
凭证
.env *.pem
系统
.DS_Store dist/ 3.render.yaml(可选,但强烈推荐) 这允许您使用“蓝图”单击一次即可部署到Render
YAML
服务:
- 类型:web
名称:salesforce ai代理商
env:节点
计划:免费
buildCommand:npm安装
startCommand:节点http-server.js
envVars :
- 键:NODE_VERSION 值:18.16.0
- 关键字:salesforce登录URL 同步:假
- 密钥:NVIDIA_API_key 同步:假
-
package.json (如前所述,确保包含type:“模块”以支持您的导入语句。)
-
http-server.js (您的主要应用程序逻辑在上一轮中提供。)