---
title: "AI 函数服务快速上手 - OceanBase AI 数据库 V4.6.3 | OceanBase 文档中心"
description: AI 函数服务快速上手 本文面向首次使用 AI 函数服务的用户，通过最少步骤完成模型注册并运行第一个示例，帮助您快速跑通流程。 本文仅使用 AI_COMPLETE 函数介绍快速上手流程，其他函数请参考 AI 函数服务语法及示例 。 说明 本文档使用新接口 REGISTER_PROVIDER 进行模型注册，从 V4.6…
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*M1BcQZvbrRMAAAAAQGAAAAgAeiGDAQ/original) OceanBase AI 数据库V 4.6.3

# AI 函数服务快速上手

更新时间：2026-11-12 18:02:53

[编辑](https://github.com/oceanbase/oceanbase-database-ai/edit/V4.6.3/zh-CN/700.reference/480.ai-function/100.ai-function-quick-start.md)  

本文面向首次使用 AI 函数服务的用户，通过最少步骤完成模型注册并运行第一个示例，帮助您快速跑通流程。

本文仅使用 `AI_COMPLETE` 函数介绍快速上手流程，其他函数请参考 [AI 函数服务语法及示例](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007088417)。

#### 说明

本文档使用新接口 `REGISTER_PROVIDER` 进行模型注册，从 V4.6.2.1 版本开始支持。旧接口 `CREATE_AI_MODEL` 等 PL 系统包子程序完整保留，存量用法可继续工作。

## 前提条件

- 已部署 OceanBase AI 数据库并创建用户租户，且已连接到数据库。
 - 已具备 AI 函数相关权限。详见 [AI 函数服务权限](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007088415)。
 - 已获取第三方模型服务的 API Key。

## 快速上手

### 步骤一：注册厂商配置

在首次使用前，需先注册厂商配置。本示例使用内置厂商 `aliyun`，只需填写 `access_key`，`protocol` 与 `base_url` 可省略，系统会自动填充默认值。请将 `access_key` 替换为实际的 API Key：

```sql
-- 本示例使用的是文本生成模型的 API Key
CALL DBMS_AI_SERVICE.REGISTER_PROVIDER('aliyun', '{
  "access_key": "sk-xxxx"
}');

```

更多厂商配置方式请参见文末相关文档。

### 步骤二：（可选）配置模型参数

如需为特定模型设置调用参数，可使用 `ALTER_MODEL_PROFILE`：

```sql
CALL DBMS_AI_SERVICE.ALTER_MODEL_PROFILE('aliyun/qwen-plus', '{
  "model_config": {
    "max_tokens": 4096,
    "temperature": 0
  }
}');

```

### 步骤三：运行示例

使用 `provider/model` 格式调用 `AI_COMPLETE`，对一段文本做情感判断：

```sql
SELECT AI_COMPLETE('aliyun/qwen-plus', AI_PROMPT('你的任务是对提供的文本进行情感分析，判断其情感倾向为正面还是负面。
    以下是需要分析的文本：
    <text>
    {0}
    </text>
    判断标准如下：
    如果文本表达的是正面情感，输出 1；如果文本表达的是负面情感，输出 -1。不要输出其他东西。', '天气真好啊')) AS sentiment;

```

预期返回结果中 `sentiment` 为 `1`，表示正面情感。

### 步骤四：（可选）使用网关（Gateway）路由

如需在多个模型端点间做加权路由与容灾，可创建 AI 网关，同时配置端点权重与熔断参数：

```sql
CALL DBMS_AI_SERVICE.CREATE_AI_GATEWAY('prod_gateway', '{
  "endpoints": [
    {"name":"ep1","model":"aliyun/qwen-plus","weight":70},
    {"name":"ep2","model":"deepseek/deepseek-chat","weight":30}
  ],
  "circuit_breaker": {
    "failure_rate_threshold": 50,
    "window_size_seconds": 60,
    "minimum_requests": 10,
    "break_duration_seconds": 60,
    "probe_requests": 3
  }
}');

```

创建后，可通过 Gateway 名称调用 AI 函数。Gateway 语法说明请参见 [CREATE_AI_GATEWAY](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007090267)。

### 步骤五：综合应用（可选）

将多个 AI 函数组合使用，构建一个简单的智能问答系统。

1. 注册所需厂商配置（可跳过）

   本示例需要嵌入模型、文本生成模型和重排序模型。若步骤一已注册 `aliyun` 厂商配置，且对应模型均通过该厂商访问，可跳过本步；否则请注册其他厂商配置：

   ```sql
   CALL DBMS_AI_SERVICE.REGISTER_PROVIDER('deepseek', '{
     "access_key": "sk-xxxx"
   }');

   ```
 2. 准备数据并生成向量

   ```sql
   CREATE TABLE knowledge_base (
       id INT AUTO_INCREMENT PRIMARY KEY,
       title VARCHAR(255),
       content TEXT,
       embedding TEXT
   );

   INSERT INTO knowledge_base (title, content) VALUES
       ('OceanBase 简介', 'OceanBase 是一个强大的数据库系统，支持向量搜索和 AI 函数。'),
       ('向量搜索', '向量搜索可以用于语义搜索，找到相似的内容。'),
       ('AI 函数', 'AI 函数可以在 SQL 中直接调用 AI 模型。');

   UPDATE knowledge_base
   SET embedding = AI_EMBED('aliyun/text-embedding-v3', content);

   ```
 3. 向量搜索并重排序

   ```sql
   SET @query = "什么是向量搜索？";
   SET @query_vector = AI_EMBED('aliyun/text-embedding-v3', @query);

   -- 直接构建字符串数组格式的文档列表
   SET @candidate_docs = '["OceanBase 是一个强大的数据库系统，支持向量搜索和 AI 函数。", "向量搜索可以用于语义搜索，找到相似的内容。"]';

   SELECT AI_RERANK('aliyun/gte-rerank-v2', @query, @candidate_docs) AS ranked_results;

   ```

   返回结果如下，`index` 为文档索引，`relevance_score` 为相关性分数：

   ```sql
   +-------------------------------------------------------------------------------------------------------------+
   | ranked_results                                                                                              |
   +-------------------------------------------------------------------------------------------------------------+
   | [{"index": 1, "relevance_score": 0.9904329776763916}, {"index": 0, "relevance_score": 0.16993996500968933}] |
   +-------------------------------------------------------------------------------------------------------------+
   1 row in set

   ```
 4. 生成答案

   基于检索与重排序结果，生成答案：

   ```sql
   SELECT AI_COMPLETE('aliyun/qwen-plus',
       AI_PROMPT('基于以下文档内容，回答用户的问题。
       用户问题：{0}

       相关文档：{1}

       请基于以上文档内容，简洁准确地回答用户的问题。', @query, CAST(JSON_EXTRACT(@candidate_docs, '$[1]') AS CHAR))) AS answer;

   ```

   返回结果如下：

   ```sql
   +--------------------------------------------------------------------------------------------------------------------------------------------+
   | answer                                                                                                                                     |
   +--------------------------------------------------------------------------------------------------------------------------------------------+
   | 根据提供的文档内容，向量搜索是一种用于语义搜索的技术，旨在通过比对向量数据来找到相似的内容。                                               |
   +--------------------------------------------------------------------------------------------------------------------------------------------+
   1 row in set

   ```

   通过上述步骤，您可以在 OceanBase AI 数据库内快速完成完整的 AI 应用流程：向量化、搜索、重排序、生成答案。

## 相关文档

- [AI 模型注册](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007088416)：网关与熔断配置及厂商信息配置。
 - [AI 函数语法及示例](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007088417)：各函数语法、参数表及更多示例。
 - [AI 函数服务权限](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000007088415)：权限授予与回收。

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线
