常规变量：Agent 加载技能时，会直接将这类变量加载到运行环境中。由于使用者在查看智能体的思考和规划过程时可能会看到变量的值，因此常规变量适合存储非敏感信息，例如 API 的 Base URL。
凭证变量：为了保障凭证安全，当 Agent 加载技能时，系统使用占位符来代替凭证变量。只有在技能实际发起 API 调用时，系统才会通过服务端代理加载真实凭证。

凭证变量

认证方式

凭证变量支持以下两种认证方式：

API Key：适用于通过 API 密钥进行鉴权的场景，例如调用火山方舟模型 API。
OAuth：适用于需要 OAuth 协议授权的场景。授权方式包括：
- 平台授权：扣子官方已集成的常用第三方平台（如飞书、Notion 等），开发者无需自行配置 OAuth 参数。
- 自建授权：对于扣子未支持的平台，或者开发者希望使用自己的授权参数，可以手动配置 OAuth 授权所需的所有参数。

赋值方式

根据由谁提供凭证，凭证变量分为以下两种：

开发者变量：由技能开发者填写变量值，Agent 调用技能时，使用开发者的秘钥等敏感信息发送请求。开发者变量通常是全局固定参数，不因用户的变化而改变，例如第三方服务的密钥。
消费者变量：技能安装时将提醒用户填写变量值，使用消费者的秘钥，例如用户自己的公众号 AppID、secret 等。不同用户的变量值相互隔离，互不干扰。

使用场景

技能环境变量目前支持以下典型场景：

存储常规配置：用于存放非敏感、但不希望硬编码在代码中的信息，例如 API 的 Base URL。
API Key 鉴权：在调用需 API Key 作为凭证的接口时使用，例如火山方舟模型 API。
微信公众号消息鉴权：配置微信公众号凭证后，所有请求将通过**固定出口 IP (115.190.189.7) **发送。你可以将此 IP 添加到微信公众号的 IP 白名单中。
OAuth 授权：支持平台授权和自建授权两种方式，用于需要 OAuth 认证的服务集成。

注意事项

创建方式：在扣子编程中通过 AI 编程来创建技能时，支持使用凭证变量；在扣子对话中制作的技能不支持此功能。
安全提醒：关于如何安全开发与使用技能的更多信息，可参考技能安全指南。
域名配置：每个凭证变量都会关联一个域名列表。为防止凭证泄漏，当 Agent 使用该凭证调用外部 API 时，扣子平台会强制校验请求的域名是否在该列表中，以防止攻击者将凭证恶意发送到未授权的服务器。
- 对于官方托管的凭证（例如火山方舟、微信公众号、OAuth 平台授权），其关联域名由扣子平台维护，不支持修改。
- 对于扣子编程提示你自行设置的请求域名，请谨慎配置。

设置常规变量

技能常规变量的创建和方式和普通环境变量一致，你可以参考管理环境变量文档查看详细说明。

创建环境变量：

请扣子 AI 设置环境变量：

将 baseurl 设置为环境变量

设置凭证变量

步骤一：创建凭证变量

在 AI 编程中，你可以通过以下方式创建凭证变量：

自动识别：对于需要使用秘钥等敏感信息的 AI 编程任务，扣子 AI 会自动识别并提示你将敏感字段封装为变量。例如要求调用火山方舟模型，扣子 AI 将提示你讲 API Key 配置为凭证变量。
主动指令：对于已开发完成的技能，你可以直接向 AI 发送指令，例如：“请帮我识别代码中的敏感凭证信息，并进行加密。”

步骤二：设置凭证变量

扣子 AI 识别到敏感凭证后，会根据凭证方便的类型（API Key 或 OAuth），弹出对应的设置卡片。

API Key 类型

对于 API Key 类型的变量，你需要选择配置方式。例如某个技能需要调用火山方舟模型 API，则需要设置：

开发者变量：直接填写变量值，并单击继续。技能运行时将使用你填写的值发起请求。
消费者变量：单击设为消费侧变量，无需填写具体值，技能安装和运行时将由最终消费者自行填写凭证内容。

OAuth 类型

对于 OAuth 类型的变量，你需要选择授权方式，再设置配置方式。以下操作以创建一个“查询飞书云文档”的技能为例，扣子 AI 识别出需要编写脚本调用飞书 API，而飞书平台支持 OAuth 授权，因此提示用户选择授权方式。

选择授权方式。
- 平台授权：扣子官方已集成的常用第三方平台（如飞书、Notion 等），开发者无需自行配置 OAuth 参数。
- 自建授权：如果平台未被官方集成，选择此项并手动配置所有 OAuth 参数。
选择赋值方式，即使用开发者还是消费者的秘钥。
如果选择平台授权，扣子 AI 会进一步提示选择凭证变量的赋值方式。
- 消费者授权：无需填写具体值，技能安装和运行时将由最终消费者自行完成 OAuth 授权。
- 开发者授权：根据页面提示，登录你的飞书账号，完成 OAuth 授权。技能运行时将使用你的账号权限发起 API 请求，查阅飞书文档。
选择 自建授权 后，你需要提供 OAuth 授权所需的 CLIENT_ID 和 CLIENT_SECRET。对于飞书等特定平台，你还需配置 Redirect URL。
1. 根据授权信息的提供者，选择以下一种方式进行配置：
  
  开发者授权：
  
  输入飞书自建应用的 CLIENT_ID 和 CLIENT_SECRET。
  
  点击开发者授权。
  
  根据页面提示，在跳转的页面中完成您自己飞书账号的授权。
  
  消费者授权：
  4. 输入飞书自建应用的 CLIENT_ID 和 CLIENT_SECRET。
  5. 点击消费者授权。
  6. 配置完成后，当最终用户安装或使用该技能时，系统将引导他们完成各自飞书账号的授权。
  
  需要注意的是，OAuth 授权通常还需要 token_url、authorization_url、相关域名等信息，扣子 AI 会默认识别这些信息并自动配置，如果识别不够准确，你可以在 AI 编程开发环境中打开环境变量页面，自行编辑变量。
2. 对于飞书等特定平台，在其开发者后台中添加扣子的 Redirect URL，作为免登授权码跳转地址。
  以飞书开放平台为例，找到自建应用，并在安全设置 > 重定向 URL 中填写扣子指定的 URL。
  
  https://www.coze.cn/api/permission_api/project_secret/callback
完成设置之后，扣子 AI 将自动编写代码，完成技能的开发。