火山引擎AI Agent需完成开发态到运行态交付，解决访问入口、身份鉴权、环境隔离和可观测性四大问题：配置公网域名、对接IAM或OIDC认证、嵌入IGA Pages并设置iframe参数。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让火山引擎AI Agent真正被业务人员或终端用户调用，必须完成从开发态到运行态的完整交付，核心是解决访问入口、身份鉴权、环境隔离和可观测性四个问题。
配置Agent公开访问地址
进入火山引擎控制台 → 选择目标项目 → 进入「Agent Plan」服务页 → 找到已部署的Agent实例 → 点击右侧「发布设置」。
勾选「启用公网访问」，系统自动生成唯一域名（如 【agent-abc123.volces.com】），该域名不可修改，且绑定后立即生效。
注意：若未开启「HTTPS强制跳转」，部分浏览器会拦截HTTP请求，导致前端调用失败。
绑定用户身份体系
方法一：对接火山引擎IAM统一身份
在Agent配置页 →「认证方式」下拉选择「火山IAM」→ 勾选允许接入的用户组（如“市场部全员”“客服坐席组”）→ 保存后，成员登录火山控制台即可直接访问该Agent。
方法二：嵌入企业自有SSO系统
启用「OIDC协议对接」，填入你方IdP的Issuer URL、Client ID与Client Secret → 开启「自动同步用户属性」→ 用户首次访问时将自动创建映射账号并继承角色权限。
【关键前提：你的IdP必须支持RFC 7523标准的JWT Bearer Token交换】
发布到IGA Pages前端门户
第一步：确认Agent已启用「Web Embed」能力，在配置页勾选「允许iframe嵌入」。
第二步：在IGA Pages项目中新建页面，插入如下代码块：
第三步：执行 volc pages deploy 命令发布整站 → 几秒后，新页面即出现在你的IGA Pages域名下（如 https://your-brand.volces.app/ai-customer-support）。
这一步操作起来很简单，直接把文件拖进去就行。但要注意：embed参数中的theme和hide_header必须与实际UI需求一致，否则上线后用户看到的是默认浅色全屏界面，无法与品牌视觉对齐。
