需要先完成企业实名认证并开通VEI服务，然后通过控制台向导（推荐方式）或OpenAPI创建AgentKit实例，最后绑定已备案域名并开启HTTPS，才能正式上线可访问的智能体服务。

如果你想在火山引擎控制台中快速创建一个可运行的AgentKit智能体实例，首先必须完成云账号企业实名认证，并开通VEI（火山引擎智能体平台）服务。否则，无论是后续的控制台操作还是API调用，都会被系统拦截，无法继续创建和部署智能体实例。

开通VEI服务并进入AgentKit控制台

登录火山引擎控制台 → 在左上角进入产品列表 → 搜索“智能体平台” → 点击【VEI-智能体平台】→ 如果是首次访问，页面顶部会出现“立即开通”提示，点击后等待约10秒，系统会自动跳转到AgentKit工作台。

注意：未完成企业实名认证的账号无法开通VEI服务，个人实名认证账号仅支持部分基础能力，【创建生产环境Agent实例必须使用已通过企业实名认证的主账号】。

创建AgentKit实例

方法一：通过控制台向导创建（推荐新手使用）

① 在AgentKit工作台左上角点击【创建实例】按钮 → 选择地域（例如“华东1（上海）”）→ 实例名称填写“demo-sales-agent” → 实例规格选择“基础版（1核2G）” → 网络类型选择“默认VPC” → 点击【下一步】。

② 在“配置智能体能力”页面中，勾选【LLM接入】，然后下拉选择已授权的“Qwen-Max（按量付费）”模型；接着勾选【知识库】，点击右侧【新建知识库】，输入知识库名称“sales-faq”，在文件上传区域直接拖入小于50MB的sales_faq.pdf文件，等待解析状态变为“就绪”后，再返回实例配置页面并点击【提交】。

这一步一定不要跳过知识库解析状态确认。如果状态仍显示“处理中”就直接提交，虽然实例可以创建成功，但知识检索与问答能力通常无法正常使用。

方法二：通过OpenAPI调用创建（适合CI/CD自动化集成）

在准备curl命令之前，先前往【账号中心 → API密钥管理】创建一对Access Key ID和Secret，然后执行：

curl --json '{"RegionId":"cn-north-1","InstanceName":"api-sales-agent","Spec":"basic","KnowledgeBaseIds":["kb-abc123"]}' "https://vei.volcengineapi.com/?Action=CreateAgentInstance&Version=2024-08-01"
-H "Authorization: HMAC-SHA256 Credential=【你的AK】/20240510/cn-north-1/vei/request, SignedHeaders=content-type;host;x-date, Signature=【生成的签名】"
-H "X-Date: 20240510T080000Z"

其中KnowledgeBaseIds必须填写已存在的知识库ID。该ID可在控制台【知识库管理】列表中通过鼠标悬停进行复制；如果填写错误或留空，通常会导致AgentKit实例创建失败，而且系统往往不会返回明确的报错信息。

绑定自定义域名并启用HTTPS

实例创建成功后，在实例列表中找到刚创建的实例 → 点击实例名称进入详情页 → 在左侧菜单选择【网络与安全】→ 点击【绑定域名】→ 输入已完成备案的域名（如agent.example.com）→ 打开HTTPS开关 → 系统会自动申请免费的DV证书 → 等待状态变为“已生效”。

这一步通常需要3～5分钟，在此期间域名暂时无法访问。如果该域名没有托管在火山引擎DNS解析服务中，还需要手动添加CNAME记录，并指向系统提供的加速域名，否则DNS解析不会生效，域名也无法正常访问。

绑定完成后，实例的公网访问地址将变为 https://agent.example.com，原始的vei-xxx.volces.com 地址会自动跳转到这个自定义域名。