密钥管理

更新时间:
复制为 MD 格式

在使用万小智搭建网站时,某些功能的实现需要调用外部服务(如数据接口、外部模型、第三方后端服务等)。密钥管理用于集中保管这些外部服务所需的密钥(API Key),密钥加密存储且不出现在网站代码中。

外部服务通常要求提供一个密钥(API Key)来验证您的身份和调用权限。该密钥需要您先到对应的服务商处申请获取,万小智本身不提供这些外部服务的密钥。当您在 AI 对话中描述需求后,万小智会自动生成实现该功能所需的代码。如果其中需要调用外部服务,系统会自动弹出密钥配置窗口,引导您填入对应服务商提供的密钥。

万小智提供以下两种方式配置和管理密钥:

  • AI 对话中配置:系统自动识别需要的密钥并弹窗引导您完成配置,适合首次接入外部服务时使用。

  • 密钥管理页面:在控制台集中查看、添加和删除已有密钥,适合后续管理和维护。

AI 对话中配置密钥

在对话中描述网站功能需求时,如果实现该功能需要调用外部服务,系统会自动弹出密钥输入窗口,引导您完成密钥配置。

触发示例:您只需用自然语言描述需求,无需关注实现细节,例如:

  • “帮我做一个表单,用户提交后自动发送邮件到我的邮箱。”

  • “用户下单成功后,给我的手机发一条短信通知。”

  • “接入 AI 模型,对用户提交的反馈内容自动生成摘要。”

image

弹窗中根据需求展示一组或多组密钥输入项,每组包含 Key、Name、Value 三个字段:

  • Key(无需修改):系统自动生成的唯一标识,用于在代码中引用该密钥。

  • Name(可选修改):系统自动生成的中文名称,便于您后续在密钥管理页面识别,可按需修改。

  • Value(需填写):粘贴您从服务商处获取的密钥值。出于安全考虑默认以****隐藏显示,可点击image图标切换为明文查看。

image

注意事项

  • 若未填写 Value 就继续对话,弹窗卡片将变为不可操作(置灰)状态,需先完成密钥填写方可继续。

  • 密钥配置完成后,系统将在后续对话中使用该密钥调用对应的第三方 API。

管理密钥

可在万小智控制台的密钥管理页面集中管理所有已配置的密钥。

进入密钥管理页面

  1. 在应用页面顶部,单击管理进入后台管理页面。

  2. 在左侧导航栏中,单击密钥管理

密钥管理页面功能

  • 添加密钥:单击添加密钥,在弹窗中填写以下字段后保存:

    • Key:仅支持字母、数字、下划线,且必须以字母或下划线开头。

    • Name:填写中文,支持编辑。

    • Value:填写密钥值,输入内容默认以****隐藏显示,可点击image图标切换为明文显示。

    保存时系统将校验 Key 的格式,不符合规则将无法保存。

  • 查看密钥:密钥列表仅展示 Key 和 Name,不展示具体密钥值(Value)。

  • 删除密钥:单击密钥行的删除操作,弹出确认窗口,确认后删除。

    重要
    • 在删除之前,请确保应用没有正在使用此密钥,此操作无法撤销。

    • 系统默认创建的密钥不支持删除。

  • 不支持编辑:已添加的密钥不支持编辑修改,如需变更请删除后重新添加。

说明

出于安全考虑,密钥保存后将不再展示明文值。建议您在服务商处妥善留存密钥原文备份,以便后续需要更换或重新配置时使用。