SuperAPI AI 工具集

run-self-service

部署与运维

查看项目

更新于 10-16 02:06

技能介绍

用途

Run Self-Service Action Skill 是一个通过自然语言界面执行 Port 自助服务操作的技能。它充当 Port 操作的接口,让用户可以用自然语言触发 Port 中的自助服务动作。

主要能力

  • 发现可用操作:通过 list_actions() 查找与用户意图匹配的操作。
  • 获取操作模式:通过 get_action(identifier="action-name") 获取所需输入、输入类型与校验规则、审批要求。
  • 收集用户输入:针对每个必填输入提示用户,使用输入的标题和描述,展示可用的枚举选项,校验格式(如 email、URL 等),并以表单形式呈现。
  • 校验输入:在提交前检查必填字段、校验格式并与用户确认。
  • 执行操作:通过 run_action(identifier="action-name", properties={...}) 执行操作。
  • 监控执行:若操作为异步,通过 get_action_run(run_id="run-123") 获取运行状态,并报告 pending → running → success/failure 的状态变化。

使用方式

执行过程分为六个步骤:

  1. 发现可用操作:调用 list_actions(),找到与用户意图匹配的操作。
  2. 获取操作模式:调用 get_action(identifier="action-name"),获取必填输入、输入类型与校验、审批要求。
  3. 收集用户输入:对每个必填输入提示用户,使用输入的标题和描述,展示枚举选项(如有),校验格式(如 email、URL 等),并以表单形式呈现。
  4. 校验输入:提交前检查必填字段、校验格式、与用户确认。
  5. 执行操作:调用 run_action(identifier="action-name", properties={...})。
  6. 监控执行:若为异步操作,调用 get_action_run(run_id="run-123"),报告状态 pending → running → success/failure。

在收集输入时,建议一次展示一个输入以保证清晰,提供可用的默认值,内联显示校验错误,并在执行前确认。

适用场景

  • 用户想要创建云基础设施。
  • 配置新的服务或环境。
  • 触发任意 Port 自助服务操作。

示例交互包括:用户说“I need a new S3 bucket”,代理会找到 provision_s3_bucket 操作,获取模式(bucket_name、region、access_level),提示用户填写,执行操作并报告结果;用户说“Create a new microservice”,代理会找到 scaffold_service 操作,收集 name、language、team、repo visibility,执行并报告结果。

限制

资料中未提供关于收费、价格、平台支持范围、具体效果或额外使用步骤的更多信息。