用途:用于 Einstein Forecasting Prediction Tuner(ForecastingPredictive AI 应用类型)的配置管理,共三个 Aura 操作:get-tuner-setup-state 读取预测器的 AI 应用是否已配置;load-tuner-metadata 返回 Opportunity 字段目录及已保存的预测配置;save-tuner-metadata 更新预测配置并返回 AI 应用 id。均需 Predictive Forecasting、Customize Application、Modify All Data 权限,无公开的 Connect/Tooling/Metadata 替代方式,AI 应用记录为 tooling 内部对象。
前置条件:组织已启用 Predictive Forecasting;当前用户具备 Customize Application 和 Modify All Data 权限。
主要操作: 一、读取配置状态:GET /headless/invoke/analytics/forecasting-analytics/get-tuner-setup-state,返回单个布尔字段 hasAIApplication;为 false 时后续调优步骤被阻塞,需先完成上游 Einstein/AI 应用设置。 二、加载元数据:GET /headless/invoke/analytics/forecasting-analytics/load-tuner-metadata,依赖上一步;返回 availableOppFields(Opportunity 自定义字段列表)、oppPicklistFieldsAndValues(选择列表字段及值,排除 CurrencyIsoCode;存在自定义记录类型时含 RecordTypeId 与 RecordTypeInfo 条目)、predictionConfig(已保存的预测配置,新组织为 null)。 三、保存元数据:PATCH /headless/invoke/analytics/forecasting-analytics/save-tuner-metadata,依赖加载步骤;接受 predictionConfig 映射但控制器会经字符串值映射重新序列化,所有值被强制转为字符串,因此需以字符串字段发送(如 excludedFields 用 JSON 编码字符串而非原生数组);当配置同时含 AIApplicationId 和 PredictionDefinitionId 时执行更新,否则创建 ForecastingPredictive AI 应用;返回 AI 应用 id(aiAppId)。部分修改时应回传 load-tuner-metadata 读取的 predictionConfig 以保留未设置字段。
适用场景:需要以编程方式检查预测器配置状态、获取机会字段目录、或创建/更新预测配置的 Salesforce 管理任务。
限制:需启用 Predictive Forecasting 且具备上述权限;无公开 API 替代;保存时值类型会被字符串化,需注意参数格式;其余信息暂未提供。