必须先完成企业实名认证并开通vei服务，再通过控制台向导（推荐）或openapi创建agentkit实例，最后绑定已备案域名并启用https。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在火山引擎控制台快速创建一个可运行的AgentKit智能体实例，必须先完成云账号实名认证并开通VEI（火山引擎智能体平台）服务，否则后续所有API调用和控制台操作都会被拦截。
开通VEI服务并进入AgentKit控制台
登录火山引擎控制台 → 左上角产品列表 → 搜索“智能体平台” → 点击【VEI-智能体平台】→ 若首次访问，页面顶部会提示“立即开通”，点击后等待约10秒自动跳转至AgentKit工作台。
注意：未完成企业实名认证的账号无法开通VEI，个人实名仅支持部分基础功能，【创建生产环境Agent实例必须使用已通过企业实名认证的主账号】。
创建AgentKit实例
方法一：控制台向导式创建（推荐新手）
① 在AgentKit工作台左上角点击【创建实例】按钮 → 选择地域（如“华东1（上海）”）→ 实例名称填写“demo-sales-agent” → 实例规格选“基础版（1核2G）” → 网络类型选“默认VPC” → 点击【下一步】。
② 在“配置智能体能力”页，勾选【LLM接入】→ 下拉选择已授权的“Qwen-Max（按量付费）”模型 → 勾选【知识库】→ 点击右侧【新建知识库】→ 输入知识库名称“sales-faq”→ 文件上传区域直接拖入sales_faq.pdf（需小于50MB）→ 等待解析状态变为“就绪” → 返回实例配置页，点击【提交】。
这一步不能跳过知识库解析确认，若状态仍为“处理中”就提交，实例会创建成功但知识检索功能不可用。
方法二：通过OpenAPI调用创建（适合CI/CD集成）
准备curl命令前，先在【账号中心 → API密钥管理】中创建一对Access Key ID和Secret，再执行：
curl -X POST "https://vei.volcengineapi.com/?Action=CreateAgentInstance&Version=2023-08-01" \
-H "Content-Type: application/json" \
-H "Authorization: HMAC-SHA256 Credential=【你的AK】/20240510/cn-north-1/vei/request, SignedHeaders=content-type;host;x-date, Signature=【生成的签名】" \
-H "X-Date: 20240510T080000Z" \
-d '{"RegionId":"cn-north-1","InstanceName":"api-sales-agent","Spec":"basic","KnowledgeBaseIds":["kb-abc123"]}'
其中KnowledgeBaseIds必须填入已存在的知识库ID，该ID可在控制台【知识库管理】列表中鼠标悬停复制，填错或为空会导致实例创建失败且不报具体错误。
绑定自定义域名并启用HTTPS
实例创建成功后，在实例列表中找到刚创建的实例 → 点击实例名称进入详情页 → 左侧菜单选择【网络与安全】→ 点击【绑定域名】→ 输入已备案的域名（如agent.example.com）→ 开启HTTPS开关 → 系统自动申请免费DV证书 → 等待状态变为“已生效”。
这一步耗时约3～5分钟，期间域名无法访问。若域名未在火山引擎DNS解析服务中托管，需手动添加CNAME记录指向系统提供的加速域名，否则解析不生效。
绑定完成后，实例的公网访问地址即变为 https://agent.example.com，原始的vei-xxx.volces.com 地址将自动重定向至此域名。
