目的地的安全与限制

Dcision 如何保护出站请求——仅限 https、SSRF 防护、不跟随重定向、密钥——每种目的地类型发送和存储什么、谁可以配置什么,以及所有目的地限制。

出站请求

Webhook、API 请求、工作流和智能体会调用你配置的 URL,因此 Dcision 会保护每一个连接:

  • 仅限 https。URL 以 https:// 开头,或以保存完整 URL 的密钥开头。http:// URL 在保存时就会被拒绝。
  • 仅限公网地址。主机名在 Dcision 建立连接时解析,并且每个地址都在那一刻、在连接内部进行检查——一个名称不可能在检查时解析为公网地址、在请求时又解析为私有地址。字面 IP 地址同样会被检查。
  • URL 中不能包含凭据。https://user:password@… 会被拒绝:请把凭据放在请求头中,并使用密钥。
  • 不跟随重定向。3xx 响应被视为投递失败;Dcision 从不跟随它。
  • 短且有界。每次投递尝试 10 秒(LLM 和 sync 智能体调用最多 25 秒),响应最多读取 64 KB。

被拦截的地址:

范围说明
0.0.0.0/8“本”网络
10.0.0.0/8、172.16.0.0/12、192.168.0.0/16私有网络
100.64.0.0/10运营商级 NAT
127.0.0.0/8环回
169.254.0.0/16链路本地,包括云元数据服务
192.0.0.0/24、192.0.2.0/24、192.88.99.0/24、198.18.0.0/15、198.51.100.0/24、203.0.113.0/24保留、测试和基准测试范围
224.0.0.0/4、240.0.0.0/4组播、保留和广播
::、::1、fc00::/7、fe80::/10、fec0::/10、ff00::/8、2001:db8::/32、100::/64IPv6 未指定地址、环回、唯一本地、链路本地、站点本地、组播、文档和丢弃地址
IPv4 映射、IPv4 兼容、NAT64(64:ff9b::/96)和 6to4(2002::/16)地址当其内含的 IPv4 地址被拦截时也被拦截

以 .local、.internal 或 .localdomain 结尾的主机名——以及解析为任何被拦截地址的名称,例如内部服务名——同样会被拒绝。

密钥

  • 工作区密钥使用 AES-256-GCM 加密,永远不会出现在决策 schema、响应、执行日志或 Playground 中——预览会将其遮蔽为 ••••。
  • 你的请求头的值永远不会写入 Dcision 的日志;不过仍请把 token 放在密钥中,因为应用会显示每次投递请求的遮蔽预览,其中包括请求头。
  • 签名密钥同样被加密,只有管理员和所有者可以显示或轮换它。

什么会离开 Dcision

类型接收方得到什么
reply什么都不会离开:文本返回给调用方。
function什么都不会离开:函数名称和 params 返回给调用方。
llm模型提供商——在你的密钥和账户下——得到路由的提示词和输入:除非你设置了 input,否则是整个 state。
agent你的智能体得到作为 input 的整个 state、指令、工具、params 以及决策的回答。
webhook回答、置信度、加权等级、复合指标、行动、原因和 params——从不包含 state。
workflowparams 和决策的回答——从不包含 state。
http正好是你的 URL、请求头和请求体模板所包含的内容。

只映射接收方需要的内容:params 是目的地的数据最小化工具。

Dcision 存储什么

  • 执行记录保留本次运行的 destinations 条目——包括函数 params、固定回复、LLM 文本和智能体回答——无论决策的 storeInput 和 storeOutput 设置如何。它们遵循执行记录的日志保留期,并出现在 GET /v1/executions 中。如果 params 携带个人数据,这些条目也会包含。
  • 投递保留其状态、尝试次数、响应的状态码、延迟和前 1,024 个字符、请求的遮蔽预览——方法、URL、请求头和请求体大小,从不包含请求体——以及在可能重新发送期间加密保存的完整请求。它们在创建 30 天后被删除。

关于 Dcision 存储的其他内容,参见安全与数据。

谁可以配置什么

操作查看者成员管理员所有者
查看目的地、投递及其状态✓✓✓✓
添加、编辑和部署目的地—✓✓✓
在 Playground 中真实执行目的地—✓✓✓
重新发送失败的投递—✓✓✓
查看密钥名称—✓✓✓
管理密钥和签名密钥——✓✓
保存 LLM 服务商密钥(设置 → 引擎)——✓✓

限制

限制值
每个决策的目的地数20
每次执行触发的目的地数10
每次执行的 LLM 回答和 sync 智能体数3
每个目的地的条件数5
每个目的地的 params 数30
固定 param 值最多 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 毫秒,默认 20,000
LLM maxTokens16 到 2,048,默认 512
LLM temperature0 到 2,默认 0.3
在 response 中返回的智能体回答最多 16,000 个字符
投递尝试6 次,历时约 7 小时
投递尝试超时10 秒
每个工作区的投递每分钟 600 次
投递保留期30 天
工作区密钥50 个,值最多 4,096 个字符

本页内容