功能说明

自定义域名管理用于配置沙箱访问地址中的域名后缀。智能体引擎中沙箱的实际访问地址由平台分配前缀（包含实例标识等信息）与您配置的自定义域名共同组成，并通过 HTTPS 提供安全访问。

通过该功能，您可以完成以下操作：

• 新增自定义域名，并通过该域名访问沙箱。

• 绑定或更换 HTTPS 证书。

• 查看域名接入状态并进行删除管理。

典型应用场景

• 统一业务入口标识：将可识别的业务域名作为访问地址后缀，便于对外发布与内部协作识别。

• 多环境域名隔离：为开发、测试、生产配置不同自定义域名后缀，避免环境混用和误调用。

使用限制

• 不支持中文域名，自定义域名必须为泛域名，格式如 *.mydomain.com。

• 由于域名解析本身是不区分大小写，因此自定义域名生效时会被处理成全小写。

• 必须为域名配置TXT记录，用于验证该域名的合法性。详见下方操作步骤。

• 必须为域名配置CNAME解析，否则会导致域名无法访问智能体。详见下方操作步骤。

• 证书必须与自定义域名匹配。

• 域名总长度最大支持 128 个字符。

• 每级子域名至少包含 1 个字符，可使用字母、数字（0-9）或连字符（-）。

• 每级子域名首字符不能为连字符（-）。

• 顶级域名长度至少 2 个字符，且必须为字母。

• 必须设置一个域名为沙箱调试默认域名，否则无法在智能体引擎控制台上使用沙箱调试功能。

操作步骤

步骤一：进入控制台并创建自定义域名

1. 登录智能体引擎控制台，在左侧导航栏中选择域名管理。

2. 点击创建域名，进入创建页面。

步骤二：配置自定义域名的TXT记录

1. 在域名中填写自定义域名（例如mydomain.com）。

2. 填写完成后，创建页面的TXT记录值部分会自动生成TXT记录的配置方法。您需要前往您的DNS服务商控制台，根据TXT记录值的Key部分的指引，为mydomain.com新增_age_verify的主机记录，并配置TXT记录值为TXT记录值的Value部分的内容。

3. 等待TXT记录解析生效后，返回域名创建页面继续配置。 

步骤三：配置 DNS CNAME 解析

1. 在创建页面查看平台提供的 CNAME 目标值（公网或内网）。

2. 前往您的 DNS 服务商控制台，为自定义泛域名添加 CNAME 记录并指向上述目标值。

3. 完成解析后返回智能体引擎控制台继续配置。 

步骤三：填写必要参数

1. 在域名中填写自定义泛域名（例如 *.mydomain.com）。

2. 在 HTTPS 设置中填写证书名称、PEM 证书内容与PEM 证书密钥。

3. 点击确认完成创建。