volcengine-sale

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

volcengine-sale

volcengine-sale

火山商品交易统一入口,编排 buy(开通购买)/ price(询价)/ unsubscribe(退订) 三个动作。客户完整交易链路是询价 → 购买 → 退订,也可以单独使用其中任一能力。
Unified entry point for Volcengine product transactions, orchestrating three actions: buy (purchase/provision) / price (pricing inquiry) / unsubscribe (cancel subscription). The complete customer transaction journey is pricing inquiry → purchase → unsubscribe, and any individual capability can also be used independently.

How to use

How to use

  1. 按下方「意图路由」表判定用户的交易动作。
  2. 读该动作的流程文件,按其中的步骤执行。
  1. Determine the user's transaction action using the "Intent Routing" table below.
  2. Read the workflow file for that action and execute its steps.

意图路由

Intent routing

动作关键词(中英,大小写不敏感)流程文件
price 询价多少钱、价格、报价、费用、收费、怎么收费、如何计费、计费方式、计费规则、收费标准、价格表、单价、总价、预估费用、成本、预算、price、pricing、quote、costreferences/price/README.md
unsubscribe 退订退订、退款、取消订阅、不想要了、退掉、不续了、unsubscribe、cancel subscription、refundreferences/unsubscribe/README.md
buy 开通购买开通、购买、下单、买、售卖、想买、订购、buy、purchase、subscribe、provisionreferences/buy/README.md
只处理命中上表的诉求。 未命中任何一行即不属于本 skill 范畴,说明本 skill 只承接询价、购买、退订三类交易执行场景,返还上层 agent,不调用任何交易接口、不做兜底解答。
常见的未命中场景:已出账账单与欠费明细(计量计费争议)、优惠与代金券申请、议价与报价单盖章、免费额度咨询。这类诉求即使提到了商品名或金额,也不进入本 skill 流程。
  • 同时命中 price + buy(例:"ECS 多少钱,帮我买一台")→ 先执行 price,用户确认价格后再询问是否进入 buy。
  • 其他组合同时命中 → 让用户拆成多条意图,不要并行执行。
ActionKeywords (Chinese and English, case-insensitive)Workflow file
price (pricing inquiry)多少钱、价格、报价、费用、收费、怎么收费、如何计费、计费方式、计费规则、收费标准、价格表、单价、总价、预估费用、成本、预算、price、pricing、quote、costreferences/price/README.md
unsubscribe (cancel subscription)退订、退款、取消订阅、不想要了、退掉、不续了、unsubscribe、cancel subscription、refundreferences/unsubscribe/README.md
buy (purchase/provision)开通、购买、下单、买、售卖、想买、订购、buy、purchase、subscribe、provisionreferences/buy/README.md
Only handle requests that match the table above. If no row is matched, the request is outside the scope of this skill. Explain that this skill only handles pricing inquiries, purchases, and subscription cancellations, then return to the upper-level agent. Do not call any transaction APIs or provide a fallback answer.
Common out-of-scope scenarios include issued-bill and overdue-payment details, metering and billing disputes, discount and voucher applications, negotiated pricing, and approval-stamped quotations. Even if these requests mention a product name or amount, they do not enter this skill's workflow.
  • Both price and buy are matched (e.g., "How much does ECS cost? Help me buy one.") → Execute price first, and after the user confirms the price, ask whether they want to proceed with buy.
  • Any other combination is matched → Ask the user to split the request into separate intents; do not execute them in parallel.

对客表述

Customer-facing wording

商品一律只说中文名称,不出现商品编码的字段名与取值。用客户说的商品名在商品清单中匹配,匹配不到就直接问客户是哪个商品——仅限流程确实需要商品编码作为入参时。退订流程的商品编码取自实例查询的返回值,不得为此追问客户。
需要配置与计费项时,直接说明需要配置编码与计费项编码,不用业务说法代替。客户提供不了则按流程降级。
命令本身、报错原文、客户主动使用的编码,原样展示不改写。
Always refer to products using their Chinese names. Do not display field names or values for product codes. Use the product name provided by the customer to match it against the product list. If no match is found, ask the customer which product they mean—only when the workflow actually requires a product code as an input. In the unsubscribe workflow, obtain the product code from the instance query response; do not ask the customer for it.
When a configuration code or billing item code is required, directly state that a configuration code and billing item code are needed instead of using business-language descriptions. If the customer cannot provide them, fall back according to the workflow.
Display commands, raw error messages, and codes proactively provided by the customer exactly as they are, without rewriting them.

登录与凭证

Login and credentials

由
ve
自身负责。命令返回鉴权错误时交给 volcengine-cli skill 走
ve login
,本 skill 不做登录态前置检查,与 ECS / VPC 等其他
ve
调用保持一致。
This is handled by
ve
itself. When a command returns an authentication error, delegate it to the volcengine-cli skill to run
ve login
. This skill does not perform a pre-login state check and remains consistent with other
ve
invocations such as ECS and VPC.

依赖 skill 自动加载

Automatic loading of dependent skills

本 skill 转交的目标 skill 未加载时,统一执行以下流程:
  1. 请求用户授权:向用户说明"需要安装
    <skill-name>
    才能继续处理
    <商品>
    ,是否允许自动安装?",等待明确许可。
  2. 授权后自动安装:
    • 目标 skill 在 volcengine-skills marketplace 内:调用
      volcengine-find-skills
      拉起安装。
    • 目标 skill 在外部 GitHub 仓库(如 ark-cli / ve-tls-cli):按流程文件里给出的源码 URL 自动 clone / 按 README 完成安装。
  3. 失败如实告知:任何一步失败都要向用户说明卡点(授权、网络、权限、依赖缺失等),不得跳过授权直接执行,也不得谎称已安装。
When a target skill transferred by this skill has not been loaded, consistently perform the following workflow:
  1. Request user authorization: Explain, "Installing
    <skill-name>
    is required to continue handling
    <product>
    . Is automatic installation allowed?" and wait for explicit permission.
  2. Install automatically after authorization:
    • If the target skill is available in the volcengine-skills marketplace, invoke
      volcengine-find-skills
      to initiate installation.
    • If the target skill is in an external GitHub repository, such as ark-cli or ve-tls-cli, automatically clone it using the source URL in the workflow file or complete the installation according to the README.
  3. Report failures accurately: If any step fails, explain the blocker to the user, such as authorization, network access, permissions, or missing dependencies. Do not skip authorization or execute the installation directly, and do not claim that the skill was installed when it was not.