用途:该技能为通过 CData Connect AI 查询 Salesforce 数据提供专门指导,需先定位并加载 connect-ai-base 技能;若该基础技能未加载、未启用或未安装,应停止任务并提示用户先安装启用。它替代 Salesforce 驱动的 getInstructions,识别连接后直接进行模式发现。
主要能力:Salesforce 为单模式驱动,模式名为 Salesforce。流程为:用 getCatalogs 过滤 DRIVER = 'Salesforce' 识别连接;用 getTables 定位对象,自定义对象用 tableName: "%__c";写查询前用 getColumns 检查列;先 SELECT * … LIMIT 5 抽样;大对象查询必须加 CreatedDate 或 LastModifiedDate 日期过滤,否则可能超时;逐步添加 JOIN 与聚合。若 getTables 或 getProcedures 不可用,可通过 queryData 查询 sys_tables、sys_procedures 等系统目录表。
数据模型:核心对象包括 Account、Contact、Lead、Opportunity、Case、Campaign,以及虚拟表 PickListValues。自定义对象与字段使用 __c 后缀。常见关系如 Contact.AccountId 关联 Account,Opportunity.AccountId 关联 Account,Case 关联 Account 与 Contact,Campaign.ParentId 表示层级。
存储过程:包括 ConvertLead(将 Lead 转换为 Account、Contact,可选 Opportunity)、GetUpdated、GetDeleted、Search(支持纯搜索词或 SOSL)、Merge、Undelete、GetRecordCount、GetUserInformation、GetLimitInfo、DownloadAttachment 等。通过 toolkit 调用时使用 EXEC 关键字、全限定过程名与位置参数 @p1、@p2 等,参数值内联在 sql 字符串中。
限制:文件上传类过程(UploadAttachment、UploadContentDocument、UploadDocument)可能不可用,因为需要 MCP 无法提供的 InputStream;DownloadContentDocument 与 DownloadDocument 需验证;GetRecordCount 结果可能滞后,准确计数应使用 COUNT(*);时间戳中的秒会被 Salesforce API 忽略。资料未提供收费、价格与平台支持等细节。