服务开通与配置

AI搜索开放平台专注智能搜索场景，提供文档切片、向量化、排序及大模型等核心算法组件化服务。行业算法版支持一键接入AI搜索开放平台的算法服务，开发者可按需调用模块化能力，快速构建智能搜索系统。

使用流程

使用示例

1. 购买行业算法版实例。

2. 单击一键接入开通AI搜索开放平台服务。

   重要

   您使用该功能将使得您的业务数据传输至产品部署（中国上海）的区域进行处理，因您的配置而异，可能会涉及跨境数据传输，以下信息需要您知晓并遵守：

   • 如涉及跨境数据传输，使用本功能，即表示您确保您业务数据的跨境传输符合所有适用法律，包括提供充分的数据保护、提供充分的隐私声明、获得有关个人的必要同意等，且您的业务数据不含任何适用法律限制或禁止传输或披露的内容。

   • 您在此声明并保证，您将遵守以上合规要求。如因您违反前述声明与保证，导致阿里云和/或其关联公司遭受任何损失，您应承担赔偿责任。

   

   接入AI搜索开放平台服务后，您可以看到服务调用相关信息：

   界面	说明
   	工作空间：用于隔离和管理不同的业务数据，首次开通AI搜索开放平台服务后，系统自动创建Default空间，您也可以创建更多空间隔离不同业务。 AI搜索开放平台支持通过空间+RAM用户授权方式，让RAM用户最小化权限使用AI服务，增加数据安全，详情参见空间管理和RAM用户授权。 当前RAM账号有多个工作空间的使用权限时，单击编辑切换空间。
   	接入地址：AI搜索开放平台支持通过公网访问服务，也支持杭州、深圳、北京、张家口、青岛地域的用户通过VPC地址跨地域调用AI搜索开放平台的服务。 单击编辑配置行业算法版实例通过公网或者VPC地址调用服务，默认为VPC。
   	API Key：调用服务时的身份认证信息。如果您需要将指定工作空间下的API Key授权给RAM用户使用，需要给RAM用户授予相关的权限。 存在多个API Key或者API Key失效时，单击编辑切换API Key。API Key失效时，页面会提示您更新，同时，业务系统使用搜索业务时也会返回报错信息。

   开通AI搜索开放平台服务后，您也可以将地域切换为上海，体验AI搜索开放平台提供的更多服务。

   

3. 配置应用结构，具体步骤包含添加搜索业务数据源信息、定义主表、配置多表之间的关联关系、表主键、字段映射类型等信息。

4. 配置索引结构，字段类型为TEXT、SHORT_TEXT时，分析方式可选择使用向量分析（包含AI搜索开放平台提供的多维度文本向量化服务和行业算法版独享型实例内置的向量化模型）服务，后续导入业务数据时，可以直接导入原始文本数据，通过此处的文本向量化服务完成数据向量化，如何计费请参见计费规则。

   

5. 配置数据源，本实例中的业务数据存储在MaxCompute中，根据MaxCompute数据特性，行业算法版允许用户指定数据导入的分区，支持通过正则表达式导入前一天的数据构建索引，可参见配置MaxCompute 数据源掌握更多数据分区条件写法。

   

6. 完成上述配置后，系统开始导入数据并构建索引，通过实例详情页查看任务进度。

   

   应用状态为正常时，表示索引构建完成。

   

7. 配置搜索召回时使用的向量模型，单击搜索算法中心>召回配置>查询分析器配置，在功能选择模块选择文本向量化，向量索引值为步骤4中配置的索引名称。一个应用中可以添加多条查询分析器，详情参见查询分析配置。

   

8. 通过检索增强生成>智能对话对大模型及其相关参数进行配置，大模型用于对搜索结果进行摘要总结。

   

   

   

   

   关键参数说明如下：

   参数	说明
   大模型参数
   模型名称	支持选择通义千问系列和DeepSeek系列模型对搜索结果进行摘要总结。
   Prompt模板	Prompt（提示词）是您输入大模型的指令，用于明确需求并引导其生成精准、相关的回答或内容，详情请参见Prompt管理。
   模型参数	temperature: 用于控制模型生成内容的随机性和多样性程度，取值范围：[0, 2)。temperature值越大，生成内容更加多样化；temperature值越小，生成结果越单一。 top_p：控制候选Token集合的采样范围，取值范围为（0,1.0)。top_p值越大，候选Token的范围越广，生成的内容更加多样化；top_p值越小，候选Token的范围越小，输出更符合既定模式。 max_tokens：用于控制模型生成token的最大数量。
   上下文参数
   输入文档数	单次输入给大模型的文档个数。
   输入字段	配置文档中哪些字段输入给大模型。
   字段摘要
   重排模型	选择重排模型对切片进行排序： ops-bge-reranker-larger：基于BGE模型的文档打分服务，支持中英双语，最大输入token长度512。 ops-text-reranker-001：OpenSearch基于行业数据集微调训练的重排模型，支持中英双语，最大输入token长度512。
   切片模型	当搜索结果中出现较长文档时，可以对其进行切片处理。可基于文档的段落格式、文本语义或指定规则，对HTML、Markdown和TXT格式的结构化数据进行拆分。
   保留切片数	配置召回的文档切片数量，取值范围：[1, 30]。
   最大切片长度	切片长度单位为token，取值范围[100, 3000]。

9. 通过功能扩展>搜索测试对向量检索和大模型摘要总结效果进行测试。

   

   通过查询分析过程确认搜索内容是否使用了AI搜索开放平台提供的向量化服务：

   

   开启智能对话，选择步骤8配置的智能对话进行效果测试：

   

   测试效果达到业务要求时，您可以参照开发指南在业务应用中通过SDK调用搜索功能。

常见问题

调用搜索功能时，系统报错提示“6614：AI平台文本向量化失败”。

6614错误提示表示AI搜索开放平台配置发生错误导致调用服务时出错，可以按照以下步骤检查和解决：

• 检查AI搜索开放平台服务是否处于开通状态，如果服务已关闭，需要手动开通，测试搜索是否正常。

  

  

• AI搜索开放平台服务已开通，调用搜索功能时仍然报错6614，需要进行以下操作：

  • 确保API Key处于启用状态：需要您将地域切换为上海，通过AI搜索开放平台确认API Key已启用；也可以返回行业算法版单击编辑将API Key切换为已启用状态的API Key。

  • 确保当前RAM账号有工作空间的使用权限：AI搜索开放平台支持通过空间+RAM用户授权方式，让RAM用户最小化权限使用AI服务，增加数据安全。可以参照空间管理和RAM用户授权完成空间和RAM账号的授权。

  • 确保接入地址能正常访问。