sf-flex-estimator

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

sf-flex-estimator: Agentforce & Data Cloud Flex Credit Estimation

sf-flex-estimator: Agentforce & Data Cloud Flex Credit估算

Use this skill when the user needs a public-price estimate for:
  • Agentforce prompt + action consumption
  • Data Cloud monthly usage meters
  • Flex Credit scenario planning
  • cost optimization recommendations before build or rollout
This skill is for planning and estimation, not implementation.

当用户需要针对以下场景进行公开价格估算时,请使用本技能:
  • Agentforce提示+操作消耗
  • Data Cloud月度使用计量
  • Flex Credit场景规划
  • 开发或上线前的成本优化建议
本技能仅用于规划和估算,不涉及实现环节。

When This Skill Owns the Task

本技能适用的任务场景

Use
sf-flex-estimator
when the user is asking questions like:
  • "What will this Agentforce agent cost per month?"
  • "Estimate Flex Credits for 5 prompts, 8 actions, and Data Cloud grounding"
  • "Compare low / medium / high usage scenarios"
  • "How much does Private Connect add?"
  • "What Flex Credit savings do we get if we reduce streaming or action count?"
Delegate elsewhere when the user is:
  • building Builder metadata, Prompt Builder templates, or action wiring → sf-ai-agentforce
  • authoring or fixing
    .agent
    files → sf-ai-agentscript
  • implementing Data Cloud connections, streams, DMOs, segments, or activations → sf-datacloud and the phase-specific
    sf-datacloud-*
    skills
  • creating test data or operational data imports → sf-data
  • deploying metadata or runtime assets → sf-deploy

使用
sf-flex-estimator
当用户提出以下类似问题时:
  • "这个Agentforce代理每月的使用成本是多少?"
  • "估算5次提示、8次操作加上Data Cloud grounding需要消耗多少Flex Credits"
  • "对比低 / 中 / 高使用场景的成本"
  • "Private Connect会额外增加多少成本?"
  • "如果我们减少流式传输或操作次数,能节省多少Flex Credit?"
当用户有以下需求时,请转交给其他对应技能:
  • 构建Builder元数据、Prompt Builder模板或操作连线 → sf-ai-agentforce
  • 编写或修复
    .agent
    文件 → sf-ai-agentscript
  • 实现Data Cloud连接、流、DMO、细分群体或激活功能 → sf-datacloud 以及各阶段对应的
    sf-datacloud-*
    技能
  • 创建测试数据或运营数据导入 → sf-data
  • 部署元数据或运行时资产 → sf-deploy

Required Context to Gather First

首先需要收集的必要上下文信息

Ask for or infer:
  • agent prompt count by tier:
    starter
    ,
    basic
    ,
    standard
    ,
    advanced
  • action count by type:
    standard
    ,
    custom
    ,
    voice
    ,
    sandbox
  • whether token overages are expected for prompts or actions
  • monthly Data Cloud meter volumes, if Data Cloud is in scope
  • whether Private Connect is required
  • whether the estimate should model a pilot, small production, enterprise, or multiple scenarios
  • whether the user wants public list-price guidance or is trying to reconcile contract-specific commercial numbers
If the user does not know exact monthly volumes, start with a baseline template and generate multiple scenarios.

请询问或推导以下信息:
  • 各等级的代理提示次数:
    starter
    basic
    standard
    advanced
  • 各类型的操作次数:
    standard
    custom
    voice
    sandbox
  • 提示或操作是否预计会产生token超额费用
  • 如果涉及Data Cloud,需提供月度Data Cloud计量项用量
  • 是否需要使用Private Connect
  • 估算需要针对试点、小规模生产、企业级还是多场景建模
  • 用户需要公开指导价参考还是要核对特定合同的商业数字
如果用户不知道确切的月度用量,可以先从基线模板开始,生成多个场景的估算结果。

Core Pricing Model

核心定价模型

Agentforce

Agentforce

Agentforce billing is linear — no volume tiers.
ComponentFC per invocation
Starter prompt2
Basic prompt2
Standard prompt4
Advanced prompt16
Standard / custom action20
Voice action30
Sandbox action16
Agentforce计费为线性模式,无用量阶梯。
组件每次调用消耗FC数
Starter 提示2
Basic 提示2
Standard 提示4
Advanced 提示16
标准/自定义操作20
语音操作30
沙箱操作16

Data Cloud

Data Cloud

Data Cloud uses monthly cumulative tiering.
TierMonthly FC rangeMultiplier
Tier 10 - 300K1.0x
Tier 2300K - 1.5M0.8x
Tier 31.5M - 12.5M0.4x
Tier 412.5M+0.2x
Data Cloud采用月度累计阶梯定价
等级月度FC区间乘数
Tier 10 - 300K1.0x
Tier 2300K - 1.5M0.8x
Tier 31.5M - 12.5M0.4x
Tier 412.5M+0.2x

Other rules

其他规则

  • Flex Credits are priced at $0.004 per FC in this skill.
  • Private Connect adds 20% of Data Cloud spend after tiering.
  • Agentforce and Data Cloud are estimated separately, then combined.
  • Estimates in this skill use publicly documented list pricing only.
For the full meter table and examples, read:
  • references/agentforce-pricing.md
  • references/data-cloud-pricing.md

  • 本技能中Flex Credit的定价为 每个FC 0.004美元
  • Private Connect会在阶梯定价后的Data Cloud费用基础上额外收取20%
  • Agentforce和Data Cloud分开估算,再合并总费用。
  • 本技能的估算仅使用公开记录的官方定价
完整的计量表和示例请阅读:
  • references/agentforce-pricing.md
  • references/data-cloud-pricing.md

Recommended Workflow

推荐工作流程

1. Baseline the structure

1. 确定基线结构

Model the agent and Data Cloud footprint first.
Useful starting templates:
  • assets/templates/basic-agent-template.json
  • assets/templates/hybrid-agent-template.json
  • assets/templates/data-cloud-template.json
首先对代理和Data Cloud的使用规模建模。
可用的初始模板:
  • assets/templates/basic-agent-template.json
  • assets/templates/hybrid-agent-template.json
  • assets/templates/data-cloud-template.json

2. Calculate the per-invocation cost

2. 计算单次调用成本

For Agentforce, estimate:
text
per-invocation FC = prompt FC + action FC + token overage FC
针对Agentforce,估算如下:
text
per-invocation FC = prompt FC + action FC + token overage FC

3. Calculate Data Cloud base FC

3. 计算Data Cloud基础FC

Map each monthly meter volume to the current public rate card, then apply cumulative tiering.
将每个月度计量项用量映射到当前公开价目表,然后应用累计阶梯定价。

4. Generate scenarios

4. 生成场景

Use the standard scenario set unless the user provides a better one:
  • Low: 1K invocations / month
  • Medium: 10K / month
  • High: 100K / month
  • Enterprise: 500K / month
除非用户提供了更合适的场景集,否则使用标准场景集:
  • 低:每月1K次调用
  • 中:每月10K次调用
  • 高:每月100K次调用
  • 企业级:每月500K次调用

5. Validate assumptions and recommend optimizations

5. 验证假设并提供优化建议

Check for:
  • too many prompts or actions
  • unnecessary streaming usage
  • likely token overages
  • missing Private Connect handling
  • unrealistic volume assumptions

检查以下内容:
  • 提示或操作次数是否过多
  • 是否存在不必要的流式传输使用
  • 是否可能产生token超额费用
  • 是否遗漏了Private Connect的处理
  • 用量假设是否不切实际

Scripts and Templates

脚本和模板

Calculator

计算器

  • assets/calculators/flex_calculator.py
  • assets/calculators/tier_multiplier.py
  • assets/calculators/flex_calculator.py
  • assets/calculators/tier_multiplier.py

Validation helper

验证辅助工具

  • hooks/scripts/validate_estimate.py
This validator is a manual helper. It is intentionally not wired into the shared auto-validation dispatcher because generic
.json
or
.md
file patterns would create too much noise.
  • hooks/scripts/validate_estimate.py
此验证器是手动辅助工具。它特意没有接入共享自动验证调度器,因为通用的
.json
.md
文件模式会产生过多干扰。

Example commands

示例命令

bash
undefined
bash
undefined

Per-invocation estimate for a template

针对模板的单次调用估算

python3 assets/calculators/flex_calculator.py
--mode structure
--agent-def assets/templates/basic-agent-template.json
python3 assets/calculators/flex_calculator.py
--mode structure
--agent-def assets/templates/basic-agent-template.json

Scenario estimate for an Agentforce + Data Cloud design

针对Agentforce + Data Cloud设计的场景估算

python3 assets/calculators/flex_calculator.py
--mode scenarios
--agent-def assets/templates/hybrid-agent-template.json
python3 assets/calculators/flex_calculator.py
--mode scenarios
--agent-def assets/templates/hybrid-agent-template.json

Tiering only

仅计算阶梯乘数

python3 assets/calculators/tier_multiplier.py
--base-fc 5000000
--pretty
python3 assets/calculators/tier_multiplier.py
--base-fc 5000000
--pretty

Validate an estimate input document

验证估算输入文档

python3 hooks/scripts/validate_estimate.py
--input assets/templates/hybrid-agent-template.json
--verbose

---
python3 hooks/scripts/validate_estimate.py
--input assets/templates/hybrid-agent-template.json
--verbose

---

High-Signal Estimation Rules

高可信度估算规则

  • Prefer standard prompts for most production reasoning workloads.
  • Use basic prompts only for simple routing/classification.
  • Action count often dominates cost faster than prompt count.
  • Data Cloud streaming is materially more expensive than prep/query/segment meters.
  • Tiering matters only for Data Cloud, not Agentforce.
  • Private Connect applies only to Data Cloud spend in this model.
  • If the user has contract-specific pricing, treat this skill as a public baseline and note that commercial terms may differ.

  • 大多数生产推理工作负载优先选择standard提示
  • 仅简单路由/分类场景使用basic提示
  • 操作次数对成本的影响通常比提示次数更快显现。
  • Data Cloud 流式传输的成本远高于预处理/查询/细分计量项。
  • 阶梯定价仅适用于Data Cloud,不适用于Agentforce。
  • 本模型中Private Connect仅适用于Data Cloud费用。
  • 如果用户有合同专属定价,请将本技能的估算结果作为公开基线,并注明商业条款可能存在差异。

Output Format

输出格式

When the estimate is complete, present:
  1. workload summary
  2. per-invocation Agentforce cost
  3. monthly scenario table
  4. Data Cloud tiering impact
  5. top optimization recommendations
  6. confidence / validation notes
Suggested shape:
text
Flex Credit estimate: <name>
Agentforce per invocation: <fc> FC ($<cost>)
Data Cloud monthly base: <fc> FC
Scenarios: <low / medium / high / enterprise>
Optimization priorities: <1-3 bullets>
Confidence: <high / medium / low>

估算完成后,请呈现以下内容:
  1. 工作负载概要
  2. Agentforce单次调用成本
  3. 月度场景对照表
  4. Data Cloud阶梯定价影响
  5. 核心优化建议
  6. 可信度/验证说明
建议格式:
text
Flex Credit estimate: <name>
Agentforce per invocation: <fc> FC ($<cost>)
Data Cloud monthly base: <fc> FC
Scenarios: <low / medium / high / enterprise>
Optimization priorities: <1-3条要点>
Confidence: <high / medium / low>

Cross-Skill Integration

跨技能集成

NeedDelegate toWhy
build the actual agent metadatasf-ai-agentforceimplementation of Builder assets
build a deterministic
.agent
bundle
sf-ai-agentscriptauthoring and validation of Agent Script
implement Data Cloud pipeline assetssf-datacloud and
sf-datacloud-*
live Data Cloud setup
package or deploy the solutionsf-deploydeployment workflow
generate supporting test or sample datasf-datadata preparation
A common chain is:
text
sf-ai-agentforce / sf-ai-agentscript / sf-datacloud-* → sf-flex-estimator → sf-deploy

需求转交技能原因
构建实际的代理元数据sf-ai-agentforceBuilder资产实现
构建确定性的
.agent
sf-ai-agentscriptAgent Script的编写和验证
实现Data Cloud流水线资产sf-datacloud
sf-datacloud-*
线上Data Cloud搭建
打包或部署解决方案sf-deploy部署工作流
生成配套测试或示例数据sf-data数据准备
常见流程链:
text
sf-ai-agentforce / sf-ai-agentscript / sf-datacloud-* → sf-flex-estimator → sf-deploy

Reference Map

参考索引

Start here

入门参考

  • README.md
  • references/calculation-methodology.md
  • references/common-use-cases.md
  • references/edge-cases.md
  • README.md
  • references/calculation-methodology.md
  • references/common-use-cases.md
  • references/edge-cases.md

Pricing references

定价参考

  • references/agentforce-pricing.md
  • references/data-cloud-pricing.md
  • references/agentforce-pricing.md
  • references/data-cloud-pricing.md

Validation and scoring

验证和评分

  • references/scoring-rubric.md
  • hooks/scripts/validate_estimate.py
  • references/scoring-rubric.md
  • hooks/scripts/validate_estimate.py