限制
所有大小和数量限制汇总在一处——请求体、状态和 token 预算、决策 schema、目的地和投递、标识符、工作区、团队和登录限制。
API 请求
| 限制 | 值 | 超出时 |
|---|---|---|
| 请求体 | 128 KB | 413 PAYLOAD_TOO_LARGE——"Request body is too large." |
| 携带决策 schema 的请求体 | 1 MB——POST /mcp(validate_schema、create_decision、update_decision)和应用的编辑器。其中的状态仍限制为 128 KB | 413 PAYLOAD_TOO_LARGE——"Request body is too large." |
| 运行请求的请求体 | 32 MB——POST /v1/decisions/{slug}、Playground 和 POST /v1/hooks/{token}(JSON、文本或 multipart/form-data),以便状态可以携带文件 | 413 PAYLOAD_TOO_LARGE——"Request body is too large." |
状态中的文件(image、audio、file 字段) | 每个 20 MB,合计 24 MB 和 10 个文件;它们的文本合计截断到约 96,000 个字符 | 422 INVALID_STATE——"Field invoice is too large (…)" |
| 序列化后的状态(不含文件) | 128 KB 且约 32,000 token(字符数 ÷ 4,即约 128,000 个字符的 JSON) | 422 INVALID_STATE——"Field state is too large (…)" |
| 每次调用的 token 预算 | 状态加最长的问题约 32,000 token,状态加所有问题约 64,000 token | 422 INVALID_STATE——"The state plus … is too large …" |
| 列表状态中的项 | 1 到 500 | 422 INVALID_STATE——"Field state has too many items (…)" |
| 每分钟请求数 | 按套餐为 60 / 300 / 2,000 / 10,000,按工作区计算——决策和读取(GET /v1/decisions、/v1/me、/v1/executions)分开计数 | 429 RATE_LIMITED——参见速率限制 |
| 包含的用量 | Genesis 每月 1M,付费套餐更多;超出后,决策使用预付额度支付,最多到每个计费周期可选的支出上限 | 没有额度时为 402 CREDITS_EXHAUSTED,达到支出上限时为 402 SPEND_CAP_REACHED——带硬性上限的套餐为 402 QUOTA_EXCEEDED。参见套餐 |
| 引擎截止时间 | 决策的 timeoutMs:默认 5,000 ms,500 到 30,000,包括重试 | 504 ENGINE_TIMEOUT |
GET /v1/executions 每页大小 | 1 到 100,默认 20 | 400 INVALID_REQUEST |
Idempotency-Key | 1–128 个字符,取自 A–Z a–z 0–9 . _ : - | 400 INVALID_REQUEST |
X-Request-ID | 1–128 个字符,取自同一字符集 | 被替换为生成的 req_… ID(不报错) |
| 幂等重放 | 24 小时 | 视为新请求 |
Token 按序列化 JSON 的字符数 ÷ 4 估算。token 预算是 Jev 的:问题连同其指令、选项、等级和标准一起计入。
决策 schema
| 项目 | 限制 |
|---|---|
| 每个决策的问题数 | 1 到 64 |
| 每个决策的策略规则数 | 最多 50 |
| 每条规则的额外 AND 条件 | 最多 5 |
| 每个决策的复合指标数 | 最多 20 |
| 每个复合指标的项数 | 1 到 20 |
| 复合指标项的权重 | −100 到 100,不能为 0 |
| 状态字段(对象状态) | 最多 50 |
| 列表状态中的项 | 1 到 500 |
| 每个选择题的选项数 | 2 到 254,外加 other |
| 每个评分题的等级数 | 2 到 10 |
| 指令 | 1 到 8,000 个字符 |
context | 最多 8,000 个字符 |
| 选项描述、评分等级、概率标准 | 最多 2,000 个字符 |
| 状态字段描述 | 最多 255 个字符 |
策略字符串值、结构化等级的 label | 最多 255 个字符 |
| 复合指标描述 | 最多 500 个字符 |
| 键(字段、问题、复合指标、选项值) | snake_case,最多 48 个字符 |
minConfidence | 0 到 1 |
timeoutMs | 500 到 30,000 |
| 序列化后的整个 schema | 最多 1 MB(携带它的请求体) |
指令、选项描述、评分等级和标准可以是文本或 JSON;JSON 按序列化后的长度计算。参见决策 schema。
决策
| 项目 | 限制 |
|---|---|
| 名称 | 1 到 80 个字符 |
| 描述 | 最多 500 个字符 |
| Slug | 最多 64 个字符:小写字母、数字和单个短横线;首次部署后锁定 |
| 每个工作区的决策数 | Genesis 2 个,Developer 10 个,Growth 和 Enterprise 不限(402 PLAN_LIMIT_REACHED) |
工作区
| 项目 | 限制 |
|---|---|
| 有效的 API 密钥 | 每个工作区 50 个(409 CONFLICT——请先撤销一个未使用的密钥) |
| API 密钥名称 | 1 到 80 个字符 |
| 提供商(BYOK)密钥 | 8 到 512 个字符 |
| 执行日志保留期 | Genesis 7 天、Developer 14 天、Growth 30 天、Enterprise 365 天——或按工作区设置更短 |
| Playground | 每分钟 30 次运行,每天 2,000 次 |
| 登录验证码 | 6 位数字,有效期 10 分钟,可尝试 5 次,每个电子邮件每 10 分钟 3 个验证码、每天 10 个 |
| 密码登录 | 每个电子邮件 5 次错误尝试,然后等待 15 分钟 |
| 密码 | 10 到 128 个字符,包含字母和数字 |
团队
| 项目 | 限制 |
|---|---|
| 你拥有的工作区 | 10 个(409 CONFLICT) |
| 邀请 | 有效期 7 天;每个工作区和每人每小时 30 个(429 RATE_LIMITED) |
| 待处理的邀请 | 每个工作区 50 个(409 CONFLICT) |
参见团队、角色与账户。
目的地
| 限制 | 值 |
|---|---|
| 每个决策的目的地数 | 20 |
| 每次执行触发的目的地数 | 10 |
每次执行的 LLM 回答和 sync 智能体数 | 3 |
| 每个目的地的条件数 | 5 |
| 每个目的地的参数数 | 30 |
| 固定参数值 | 最多 500 个字符 |
| 每个目的地的请求头数 | 20 |
| 请求头值 | 最多 2,048 个字符 |
| URL | 最多 2,048 个字符 |
http 请求体模板 | 最多 10,000 个字符 |
| 目的地描述 | 最多 2,000 个字符 |
| 回复文本 | 最多 4,000 个字符 |
| 回复按钮 | 最多 10 个,每个最多 80 个字符 |
LLM 提示词和输入、结构化输出的 instructions 和 input | 每个最多 8,000 个字符 |
| 智能体指令 | 最多 32,000 个字符 |
| 智能体工具 | 最多 50 个 |
LLM 和 sync 智能体超时 | 1,000 到 25,000 ms,默认 20,000 |
LLM maxTokens | 16 到 2,048,默认 512 |
LLM temperature | 0 到 2,默认 0.3 |
在 response 中返回的智能体回答 | 最多 16,000 个字符 |
| 投递尝试次数 | 6 次,约 7 小时内 |
| 每次投递尝试的超时 | 10 秒 |
| 每个工作区的投递数 | 每分钟 600 次 |
| 投递保留期 | 30 天 |
| 工作区密钥 | 50 个,值最多 4,096 个字符 |
超出这些限制时,匹配的目的地会以 "reason": "limit" 被跳过,无效的目的地会使 schema 无效(422 INVALID_SCHEMA)。参见目的地的安全与限制。