出海企业在处理多语种客服、内部知识检索场景时，核心诉求是充分利用大模型能力，同时管控企业私有知识数据安全。基于阿里云国际站百炼+ OSS 对象存储架构，可以快速搭建具备 RAG 检索增强生成能力的私有 AI Agent。
本教程面向出海企业 IT 负责人与开发者，覆盖底层存储配置、知识库对接、智能体创建、验证测试全链路实操。
一、架构逻辑
整套方案两大核心组件：
- 阿里云 OSS 对象存储：存放 PDF、Word 等原始企业文档，源文件存放在企业私有 Bucket，实现源文件隔离管控。
- 阿里云百炼（Bailian Model Studio）：一站式大模型开发平台，负责文档解析、文本切片、向量化处理；调度 Qwen 系列大模型完成意图识别、知识库检索、问答输出。
合规重要说明：原始文档保存在私有 OSS；解析生成的切片与向量数据存储在百炼业务空间侧。如果业务需要满足 GDPR 等数据驻留法规，OSS Bucket 地域、百炼业务空间地域、百炼服务部署范围三者都需要匹配合规要求，不能仅依靠 OSS 地域保障数据属地。
该架构无需自行搭建维护向量数据库，控制台完成 RAM 授权即可实现完整 RAG 闭环。
二、前置准备
开始配置前，请完成如下准备：
- 阿里云国际版账号：完成实名认证并配置支付方式。不同国家、主体开户要求存在差异，注册充值遇到限制，可以咨询云枢国际 /yunshuguoji 协助梳理开户材料。
- 开通服务：控制台分别开通对象存储 OSS、百炼（Model Studio）服务；进入百炼，创建对应地域业务空间（Workspace）。
- 权限说明：主账号可以一键完成跨服务授权；生产环境使用 RAM 子账号操作，需要主账号预先授予子账号创建服务关联角色权限，否则 OSS 授权会报错。
- 测试素材：准备 2 3 份 PDF / DOCX 企业文档（产品手册、内部规范）；不支持归档、冷归档存储类型文件直接解析；文件建议上传至 Bucket 下子目录，不建议直接放在 Bucket 根目录。
三、步骤一：配置 OSS 对象存储
OSS 用来安全存放知识库原始源文件。
创建 Bucket，参数参考：
- Bucket 名称：company agent docs 2026（全局唯一）
- 地域 Region：必须和百炼业务空间地域完全一致
- 存储类型：标准存储 Standard
- 读写权限 ACL：Private 私有，严禁开启公网匿名访问
额外配置：如果 Bucket 配置了 Referer 防盗链，请将百炼控制台域名加入 Referer 白名单，否则会出现导入失败阿里云Op…；部分场景需要为 Bucket 打上标签 bailian datahub access:read 用于百炼识别访问权限。
上传文档：进入 Bucket 文件管理，将测试文档上传至自定义子目录，确认文件状态正常。
四、步骤二：百炼控制台搭建 Agent
存储配置完成后，完成 OSS 数据源授权、知识库创建、Agent 应用配置。
- 创建知识库 进入百炼控制台，切换到对应业务空间，打开「数据管理 知识库」，点击创建知识库，数据源选择从 OSS 导入。
- 根据控制台弹窗指引完成服务关联角色 RAM 授权，授予百炼读取该 OSS Bucket 权限；
- 选择 Bucket 以及存放文档的子目录，提交向量化解析任务，等待解析、切片、向量化执行到 100%。
注意：PDF 扫描件、复杂表格文档有可能解析效果差，导入后可以进入知识库查看切片，手动编辑修正异常切片内容，改善 RAG 回答质量。
- 配置 Agent 应用 进入「应用广场」新建应用，选择知识库问答 Agent 模板。
- 模型选择：Qwen Max / Qwen Plus，根据业务并发与成本选择；
- 知识检索配置：绑定已经解析完成的 OSS 知识库；可调整相似度阈值，生产环境建议开启重排模型 qwen3 rerank 提升检索精度；
- Prompt 系统提示词示例：
请严格依据知识库信息回答用户问题。知识库没有相关内容时，请直接回复“暂未掌握相关信息”，禁止编造内容。回答时尽量引用对应文档来源。
五、步骤三：链路验证
在百炼 Agent 预览窗口发起提问，输入仅测试文档内才有的专属问题。 验证两点：
- Agent 能够输出正确答案；
- 可以正确展示引用文档片段 Citation 来源。
若出现答案正确但是来源标记错乱，需要优化 Prompt 规则、调整切片粒度、开启重排模型优化召回效果。
六、常见排错
- OSS 同步导入失败检查 OSS Bucket 地域与百炼业务空间地域一致；确认 RAM 服务关联角色授权完成；子账号操作确认主账号授予创建服务关联角色权限；检查防盗链 Referer 配置；确认文件不是归档存储类型。
- 检索不到目标信息确认向量化任务进度 100%；调低知识库相似度阈值；检查文档是否解析乱码，查看切片内容；开启重排模型提升召回精度。
- 文档解析失败 / PDF 表格乱码扫描版 PDF 无法解析文本；复杂表格文档切片容易出错，手动编辑修正切片，或者转换文档格式后重新上传。
- Citation 引用来源张冠李戴优化 Prompt 引用约束；调小切片大小；开启 Rerank 重排模型；避免单切片混入多份文档内容。
七、测试环境资源清理（非常关键）
⚠️重点提醒：仅删除知识库内文件，不会停止计费；知识库实例本身才是计费主体；删除 Agent 应用不会自动删除知识库，必须分别操作，否则持续产生向量存储小时费用。
- 百炼侧：先解除 Agent 与知识库绑定；删除 Agent 应用；再单独删除知识库实例（删除不可逆）。
- OSS 侧：确认业务不再需要源文件，清空 Bucket 对象，再删除 Bucket。
私有 AI Agent 部署快速核验清单
- OSS Bucket 地域 = 百炼业务空间地域，同账号下操作
- OSS Bucket ACL 为私有；防盗链配置放行百炼控制台域名
- RAM 授权：主账号一键授权；子账号确认拥有创建服务关联角色权限
- 出海合规：OSS 地域、百炼业务空间地域、服务部署范围统一匹配数据驻留法规
- 导入文件使用 Bucket 子目录，避免根目录导入；不使用归档存储文件
- 上线前查看知识库切片，修正解析异常文档
- 测试完毕清理资源：必须删除知识库实例，不只删除文件和 Agent 应用
常见问题解答 (FAQ)：
Q1：阿里云国际版对象存储价格由哪些因素决定？ 答：价格受地域、存储规格、存储容量、公网流出流量、API 请求次数、税费影响。询价前确认目标区域、预估存储容量、峰值访问、是否开启日志、备份策略。
Q2：阿里云国际版账号注册需要准备什么资料？ 答：注册条件取决于账号地区、个人 / 企业主体、业务场景。提前确定开通地域、业务用途，准备身份验证材料、联系方式、海外支付方式。
Q3：阿里云百炼如何接入 OSS 作为知识库？ 答：在百炼数据管理模块选择 OSS 数据源，跟随控制台完成 RAM 服务关联角色授权，选择同地域 Bucket 子目录导入。子账号需要主账号额外赋权，界面以 2026 控制台最新版本为准。
Q4：出海企业如何保障数据合规？ 答：源文件存放私有 OSS 关闭公网访问；遵循 RAM 最小权限；OSS、百炼业务空间地域、百炼服务部署范围全部匹配当地数据驻留法规；不要将极高敏感机密直接上传知识库；业务上线前做合规评估。
Q5：百炼调用大模型和 OSS 存储怎么计费？ 答：OSS 计费项：存储容量、外网流量、API 请求；百炼计费：模型推理 Token 消耗、文档向量化调用、知识库实例小时存储费用。最终单价以阿里云国际官方实时定价页面为准。
Q6：删除 Agent 应用之后还会产生百炼费用吗？ 答：会。删除 Agent 应用不会自动删除知识库实例；只要知识库实例存在，就会产生向量存储费用，必须手动删除知识库实例才能停止计费。