自动化
自动化
用脚本和工作流编排平台能力,按需或自动运行。
自动化把平台能力组合成脚本或工作流,由你主动运行,或由触发器自动启动。
| 对象 | 用途 |
|---|---|
| 脚本 | 一段 TypeScript 从头执行到尾,返回一个结果。 |
| 工作流 | YAML 描述的多步骤流程,保存检查点,支持等待和暂停。 |
| 动作 | 有输入输出约定的可复用能力,由脚本或工作流调用。 |
| 运行 | 一次脚本或工作流的执行,记录输入、输出、状态和调用。 |
| 触发器 | 在指定时间或收到 webhook 时启动一个已发布的脚本或工作流。 |
选择入口
一次计算、批量处理或组合 API 调用,用脚本;跨时间等待、需要步骤检查点的任务,用工作流。把多个编排都会使用的能力封装成动作。动作没有独立运行入口,在脚本或工作流里调用它。
脚本失败后重跑会重新执行整段代码;已发生的效果不会回滚。需要自动执行时,在已发布目标上配置触发器。
先运行一次
在 Develop Console 创建 API Key,设置为 PRAXIS_API_KEY。在装有 curl 和 jq 的 Bash 中执行,使用 Bearer 认证完成一次加一计算,不调用模型:
export PRAXIS_API_URL="https://api-develop.deepraxis.ai"
: "${PRAXIS_API_KEY:?Set PRAXIS_API_KEY to your develop API Key}"
curl --fail-with-body -sS "$PRAXIS_API_URL/automation/v1/runs" \
-H "Authorization: Bearer $PRAXIS_API_KEY" \
-H 'Content-Type: application/json' \
--data '{"source":"export default async (input: { n: number }) => ({ answer: input.n + 1 });","language":"ts","input":{"n":41},"wait":60}' \
| jq '{id,status,output,error}'期望:status 为 completed,output 为 {"answer":42}。若仍在排队或运行,将返回的 id 存为 RUN_ID,再读取结果。继续按快速开始保存和发布脚本。