需在火山引擎控制台创建可运行于生产环境的ai agent：先建工作区（命名规范+选华东1上海地域），再创建标准agent应用并配置iam角色与最小权限策略，接着导入langchain代码或部署容器镜像，然后绑定textin parsex、飞书机器人及milvus向量知识库，最后发布并用curl验证调用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在火山引擎控制台创建首个AI Agent应用
你需要从零开始配置一个可运行、可调试、能接入真实业务系统的AI Agent，而不是停留在Coze画布里的Demo。这要求你明确区分开发环境与生产空间，避免用个人账号直接操作企业级资源。
打开火山引擎控制台 → 点击顶部导航栏「AI与大模型」→ 在下拉菜单中选择「AgentKit」→ 进入工作区选择页。
首次使用需先创建工作区：点击「新建工作区」→ 输入工作区名称（建议包含团队缩写+项目类型，如「market-aiagent-2026」）→ 选择地域（优先选「华东1（上海）」，该地域已全面支持AgentKit最新v2.3 Runtime）→ 点击「确认创建」。
【工作区创建后不可跨地域迁移，且名称一旦设定无法修改】
等待约8秒，页面自动跳转至AgentKit主控制台，左侧菜单出现「Agent应用」、「技能管理」、「可观测性」等模块。
配置Agent基础身份与权限模型
Agent不是匿名调用者，它必须拥有明确的身份标识和最小化访问权限，否则无法安全调用企业内部API或数据库。
点击左侧「Agent应用」→ 「创建应用」→ 选择「标准Agent」模板（不选「QuickStart」，该模板无RBAC集成能力）→ 填写应用名称（如「customer-support-v2」）→ 在「身份认证方式」中勾选「火山引擎IAM角色授权」。
此时系统自动生成一个服务关联角色（Service-Linked Role），角色名格式为：aliyun-service-role/agentkit-workspacename-appid。该角色已预置对Milvus Serverless、IGA Pages函数网关、对象存储VOLC OSS的只读策略。
关键一步：点击「高级设置」→ 展开「权限边界」→ 手动粘贴一段JSON策略片段（来自你司安全团队提供的最小权限模板），覆盖默认策略。这步跳过会导致后续调用飞书多维表格API时返回403错误。
导入或编写核心业务逻辑
AgentKit不强制你用VeADK框架，但如果你已有LangChain构建的Python Agent，需做两处轻量改造才能部署。
方法一：使用AgentKit SDK注入生命周期钩子
在主程序入口文件（如main.py）顶部添加：
from agentkit import agent_app
将原Flask/FastAPI启动逻辑包裹进@agent_app装饰器，并确保HTTP路由路径为/invoke。
方法二：容器镜像直部署（适合已打包好的Docker镜像）
准备一个符合OCI标准的镜像，要求：监听端口8080、健康检查路径为/healthz、环境变量AGENT_MODE=production已注入 → 在控制台「Agent应用」→「创建应用」→ 切换至「容器镜像」标签页 → 填写镜像地址（支持火山引擎容器镜像服务CR或第三方Harbor）→ 设置CPU/内存规格（起步选1C2G，测试通过后再升配）。
注意：镜像内不能包含pip install指令，所有依赖必须在构建阶段完成安装，运行时执行会失败。
绑定知识库与外部工具链
第一步：接入TextIn ParseX文档解析能力
在控制台左侧点击「技能管理」→ 「添加技能」→ 搜索「TextIn ParseX」→ 点击「立即启用」→ 在弹窗中选择已开通的ParseX实例（若无，请先去「智能文档」服务开通专业版）→ 勾选「PDF结构化解析」「表格OCR识别」两项能力 → 点击「授权并绑定」。
第二步：挂载飞书开放平台能力
回到当前Agent编辑页 → 点击「工具集成」→ 「添加工具」→ 选择「飞书机器人」→ 扫码登录飞书管理员账号 → 授权范围务必勾选「多维表格-全部数据读写」「云文档-内容编辑」「消息-发送到群组」→ 完成后系统自动生成一个Bot Token和App ID，显示在「已启用工具」列表中。
第三步：挂载向量知识库
点击「知识库」→ 「新建知识库」→ 类型选「Milvus Serverless」→ 输入名称（如「support-faq-embeddings」）→ 向量维度填768（匹配豆包embedding模型输出）→ 点击「创建」→ 创建完成后，点击右侧「上传文件」图标，拖入已清洗好的FAQ Markdown文件（单文件≤50MB，总容量上限2GB）→ 等待状态变为「就绪」即可。
发布与验证Agent可用性
1. 点击顶部「发布」按钮 → 弹出发布确认框 → 勾选「自动创建灰度版本」和「启用请求日志采样（1%）」→ 点击「立即发布」。
2. 发布成功后，页面跳转至「版本管理」页，看到v1.0状态为「已上线」，右侧显示「调用地址」，格式为：https://<em>xxx</em>.agentkit.volcengine.com/invoke。
3. 打开终端，执行curl命令验证：
curl -X POST https://xxx.agentkit.volcengine.com/invoke \
-H "Content-Type: application/json" \
-d '{"query":"我的订单还没发货，能查一下吗？","user_id":"test_user_001"}'
4. 查看返回JSON中的response字段是否含合理答复，同时检查「可观测性」→「实时日志」页是否有对应traceID的日志流。
