> For the complete documentation index, see [llms.txt](https://docs.convai.com/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.convai.com/api-docs/zh/api-can-kao/core-api-reference/character-crafting-apis/external-api.md).

# 外部 API

创建、列出、关联和删除外部 API 函数，以便你的角色能在对话中调用自定义 Python 代码。

{% hint style="danger" %}
此 API 仅适用于 Professional 套餐及更高套餐。
{% endhint %}

外部 API 函数是小型 Python 处理程序，角色可以在对话中将其作为工具调用。创建一次函数，将其关联到一个或多个角色，模型便会根据函数名称和描述决定何时运行它。

典型流程：

1. 使用以下接口创建函数： `/functions/create/`
2. 使用以下接口将函数关联到角色： `/character/update` (`status: "active"`)
3. 使用以下接口列出函数（可选按角色筛选）： `/functions/list/`
4. 使用以下接口将函数与角色解除关联： `/character/update` (`status: "inactive"`），或者使用以下接口彻底删除函数： `/functions/delete/`

有关 Playground UI 操作演示和示例处理程序（天气、体育比分、Jira），请参阅 [外部 API](https://docs.convai.com/api-docs/zh/convai-playground/character-customization/external-api.md).

硬性限制（支持的模型、Python 运行时、库、架构和上限）统一记录在 [外部 API 限制](https://docs.convai.com/api-docs/zh/convai-playground/character-customization/external-api/external-api-limitations.md).

## 编写函数

函数在沙盒化的 **Python 3.11** 运行时中执行。请使用纯 Python 编写，尽量精简功能范围，并返回模型可读并重新带入对话的 JSON 可序列化数据。

完整的限制列表（允许使用的库、行数上限、模型支持情况、角色数量上限）请参阅 [外部 API 限制](https://docs.convai.com/api-docs/zh/convai-playground/character-customization/external-api/external-api-limitations.md).

### 入口点： `handle_event`

每个函数 **都必须** 定义一个顶层函数，名称为 `handle_event` 该函数接收一个参数。此参数是一个字典，其中包含模型根据你的 `input_description`.

```python
def handle_event(inputs):
    # `inputs` 是一个字典，其中包含 input_description 中定义的参数。
    # 在此调用外部 API，并返回一个 JSON 可序列化的字典。
    return {"result": "ok"}
```

要求：

* 函数名称必须准确为 `handle_event`
* 函数必须接收一个参数（通常命名为 `inputs` 或 `data`)
* 返回一个 **JSON 可序列化** 的值，通常是一个 `dict`
* 不要依赖调用之间的全局可变状态——每次调用都是独立的。

以下是一个读取单个参数并调用外部 API 的最简示例：

```python
import requests

API_KEY = "<your-api-key>"

def handle_event(inputs):
    city = inputs.get("city")
    url = f"https://api.openweathermap.org/data/2.5/weather?q={city}&appid={API_KEY}"
    response = requests.get(url, timeout=10)
    response.raise_for_status()
    weather = response.json()
    return {
        "city": city,
        "description": weather["weather"][0]["description"],
        "temp_k": weather["main"]["temp"],
    }
```

### 输入描述架构

`input_description` 用于告知模型可以（且必须）传入哪些参数 `handle_event`。创建或更新时，它会以 **JSON 字符串**的形式发送，而非嵌套对象。解码后的 JSON 必须符合以下架构：

```json
{
  "type": "object",
  "properties": {
    "parameters": {
      "type": "object",
      "patternProperties": {
        "^[a-zA-Z_][a-zA-Z0-9_]*$": {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "enum": ["string", "integer", "boolean", "object", "array"]
            },
            "description": { "type": "string" }
          },
          "required": ["type", "description"]
        }
      },
      "additionalProperties": false
    },
    "required": {
      "type": "array",
      "items": { "type": "string" }
    }
  },
  "required": ["parameters", "required"]
}
```

实际含义如下：

| 字段                              | 规则                                                                  |
| ------------------------------- | ------------------------------------------------------------------- |
| `parameters`                    | 以参数名称为键的对象。此映射之外的额外键会被拒绝（`additionalProperties: false`).            |
| 参数名称                            | 必须符合 `^[a-zA-Z_][a-zA-Z0-9_]*$` （首字符为字母或 `_` 下划线，后续字符可为字母、数字或 `_`). |
| `parameters.<name>.type`        | 以下类型之一： `string`, `integer`, `boolean`, `object`, `array`.          |
| `parameters.<name>.description` | 非空字符串，模型会据此判断要传入什么值。                                                |
| `required`                      | 必须提供的参数名称数组。此处列出的名称也应存在于 `parameters`.                              |

相同规则也总结在 [外部 API 的限制](https://docs.convai.com/api-docs/zh/convai-playground/character-customization/external-api/external-api-limitations.md#input-description).

示例 `input_description` （作为对象传入——在请求正文中发送前将其转换为字符串）：

```json
{
  "parameters": {
    "city": {
      "type": "string",
      "description": "要查询天气的城市名称（例如 'London'、'Tokyo'）"
    },
    "units": {
      "type": "string",
      "description": "可选的单位制，例如 'metric' 或 'imperial'"
    }
  },
  "required": ["city"]
}
```

在 Python 中调用 create 时：

```python
input_description = json.dumps({
    "parameters": {
        "city": {
            "type": "string",
            "description": "要查询天气的城市名称"
        }
    },
    "required": ["city"]
})
```

{% hint style="info" %}
参数描述应具体明确。模型会根据这些描述选择参数，因此像 `"a value"` 这样的模糊文本会导致调用不当。建议在描述字符串中加入示例和单位。
{% endhint %}

***

## 创建函数

<mark style="color:绿色;">`POST`</mark> `https://api.convai.com/functions/create/`

在你的账户中创建一个新的外部 API 函数。只有关联该函数后，它才会附加到某个角色。

#### 请求头

| 名称                                              | 类型  | 说明                                         |
| ----------------------------------------------- | --- | ------------------------------------------ |
| CONVAI-API-KEY<mark style="color:红色;">\*</mark> | 字符串 | 为每位用户提供的唯一 API 密钥。登录 Convai 账户后，可在密钥图标下找到。 |
| Content-Type<mark style="color:红色;">\*</mark>   | 字符串 | 必须为 `application/json`                     |

#### 请求正文

| 名称                                                  | 类型  | 说明                                                                                                                                                                                                                                         |
| --------------------------------------------------- | --- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| name<mark style="color:红色;">\*</mark>               | 字符串 | 函数的显示名称。建议使用清晰的动词短语，便于模型匹配（例如 `获取天气`).                                                                                                                                                                                                     |
| description<mark style="color:红色;">\*</mark>        | 字符串 | 说明角色应在何时调用此函数。模型会根据此项选择工具。                                                                                                                                                                                                                 |
| language<mark style="color:红色;">\*</mark>           | 字符串 | 实现语言。仅支持 `python` 。                                                                                                                                                                                                                        |
| source\_code<mark style="color:红色;">\*</mark>       | 字符串 | 完整的 Python 3.11 源代码，包括 `handle_event`。最多 400 行。仅可使用标准库和 `requests` 。请参阅 [编写函数](#writing-functions) 和 [限制](https://docs.convai.com/api-docs/zh/convai-playground/character-customization/external-api/external-api-limitations.md#runtime). |
| input\_description<mark style="color:红色;">\*</mark> | 字符串 | JSON **字符串** ，用于描述参数。请参阅 [输入描述架构](#input-description-schema) 和 [限制](https://docs.convai.com/api-docs/zh/convai-playground/character-customization/external-api/external-api-limitations.md#input-description).                             |

#### 示例载荷

```json
{
  "name": "获取天气",
  "description": "获取指定城市的当前天气",
  "language": "python",
  "input_description": "{\"parameters\":{\"city\":{\"type\":\"string\",\"description\":\"要查询天气的城市名称\"}},\"required\":[\"city\"]}",
  "source_code": "import requests\n\nAPI_KEY = \"<openweather-api-key>\"\n\ndef handle_event(data):\n    city = data.get(\"city\")\n    url = f\"https://api.openweathermap.org/data/2.5/weather?q={city}&appid={API_KEY}\"\n    response = requests.get(url)\n    weather_data = response.json()\n    return {\"weather\": weather_data[\"weather\"][0][\"description\"]}\n"
}
```

{% tabs %}
{% tab title="201：已创建" %}

```json
{
  "transactionID": "<uuid>",
  "function": {
    "function_id": "<function uuid>",
    "name": "获取天气",
    "description": "获取指定城市的当前天气",
    "language": "python",
    "source_code": "import requests\n...",
    "base64_source_code": "<base64 encoded source>",
    "input_description": "{\"parameters\":{...},\"required\":[\"city\"]}",
    "created_at": "2026-03-18T12:34:56"
  }
}
```

{% endtab %}

{% tab title="400：错误请求" %}

```json
{
  "ERROR": "缺少必填字段：name",
  "Reference ID": "<uuid>"
}
```

其他常见的 400 错误消息：

* `Field input_description must be a valid json string`
* `Language pythonx not supported`
* 无效项导致的架构错误： `input_description`
* 源代码验证失败（为空、超过 400 行或被判定为恶意代码）
  {% endtab %}

{% tab title="401：未授权" %}

```json
{
  "ERROR": "提供的 API 密钥无效。"
}
```

{% endtab %}
{% endtabs %}

以下是一些示例代码，用于演示此端点的请求格式 -->

{% tabs %}
{% tab title="Python" %}
{% code overflow="wrap" %}

```python
import json
import requests

url = "https://api.convai.com/functions/create/"

input_description = {
    "parameters": {
        "city": {
            "type": "string",
            "description": "要查询天气的城市名称"
        }
    },
    "required": ["city"]
}

source_code = """
import requests

API_KEY = "<openweather-api-key>"

def handle_event(data):
    city = data.get("city")
    url = f"https://api.openweathermap.org/data/2.5/weather?q={city}&appid={API_KEY}"
    response = requests.get(url)
    weather_data = response.json()
    return {"weather": weather_data["weather"][0]["description"]}
""".strip()

payload = json.dumps({
    "name": "获取天气",
    "description": "获取指定城市的当前天气",
    "language": "python",
    "input_description": json.dumps(input_description),
    "source_code": source_code
})

headers = {
    "CONVAI-API-KEY": "<your api key>",
    "Content-Type": "application/json"
}

response = requests.post(url, headers=headers, data=payload)
print(response.text)
```

{% endcode %}
{% endtab %}

{% tab title="cURL" %}
{% code overflow="wrap" %}

```shell
curl --location --request POST 'https://api.convai.com/functions/create/' \
--header 'CONVAI-API-KEY: <your api key>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "name": "获取天气",
  "description": "获取指定城市的当前天气",
  "language": "python",
  "input_description": "{\"parameters\":{\"city\":{\"type\":\"string\",\"description\":\"要查询天气的城市名称\"}},\"required\":[\"city\"]}",
  "source_code": "import requests\n\nAPI_KEY = \"<openweather-api-key>\"\n\ndef handle_event(data):\n    city = data.get(\"city\")\n    url = f\"https://api.openweathermap.org/data/2.5/weather?q={city}&appid={API_KEY}\"\n    response = requests.get(url)\n    weather_data = response.json()\n    return {\"weather\": weather_data[\"weather\"][0][\"description\"]}\n"
}'
```

{% endcode %}
{% endtab %}
{% endtabs %}

***

## 列出函数

<mark style="color:绿色;">`POST`</mark> `https://api.convai.com/functions/list/`

返回你账户中的外部 API 函数。传入 `character_id` 可包含每个函数与该角色的关联状态（`active` 或 `inactive`).

#### 请求头

| 名称                                              | 类型  | 说明                                         |
| ----------------------------------------------- | --- | ------------------------------------------ |
| CONVAI-API-KEY<mark style="color:红色;">\*</mark> | 字符串 | 为每位用户提供的唯一 API 密钥。登录 Convai 账户后，可在密钥图标下找到。 |

#### 请求正文

所有字段均为可选项。请求体为空时，将列出账户中的所有函数。

| 名称    | 类型  | 说明                                                         |
| ----- | --- | ---------------------------------------------------------- |
| 角色 ID | 字符串 | 如果设置了此字段，每个函数都会包含相对于该角色的 `status` （`active` / `inactive`). |
| 每页条数  | 整数  | 每页的条目数。默认 `-1` （返回全部）。设置为正数时，将添加分页字段。                      |
| 页码    | 整数  | 页码，从 `1`开始。仅在 `per_page` 不为 `-1`时使用。默认值为 `1`.              |

#### 示例载荷

```json
{
  "character_id": "<character uuid>",
  "per_page": 20,
  "page": 1
}
```

{% tabs %}
{% tab title="200：成功" %}

```json
{
  "transactionID": "<uuid>",
  "functions": [
    {
      "function_id": "<function uuid>",
      "name": "获取天气",
      "description": "获取指定城市的当前天气",
      "language": "python",
      "created_at": "2026-03-18T12:34:56",
      "status": "active"
    }
  ],
  "total_pages": 1,
  "per_page": 20,
  "page": 1,
  "total": 1
}
```

`total_pages`, `per_page`, `page`，以及 `total` 仅在 `per_page` 为正整数时才会出现。
{% endtab %}

{% tab title="400：错误请求" %}

```json
{
  "ERROR": "Failed to get functions with response: ...",
  "Reference ID": "<uuid>"
}
```

{% endtab %}

{% tab title="401：未授权" %}

```json
{
  "ERROR": "提供的 API 密钥无效。"
}
```

{% endtab %}
{% endtabs %}

以下是一些示例代码，用于演示此端点的请求格式 -->

{% tabs %}
{% tab title="Python" %}
{% code overflow="wrap" %}

```python
import json
import requests

url = "https://api.convai.com/functions/list/"

payload = json.dumps({
    "character_id": "<character uuid>",
    "per_page": 20,
    "page": 1
})
headers = {
    "CONVAI-API-KEY": "<your api key>",
    "Content-Type": "application/json"
}

response = requests.post(url, headers=headers, data=payload)
print(response.text)
```

{% endcode %}
{% endtab %}

{% tab title="cURL" %}
{% code overflow="wrap" %}

```shell
curl --location --request POST 'https://api.convai.com/functions/list/' \
--header 'CONVAI-API-KEY: <your api key>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "character_id": "<character uuid>",
  "per_page": 20,
  "page": 1
}'
```

{% endcode %}
{% endtab %}
{% endtabs %}

***

## 将函数关联到角色

<mark style="color:绿色;">`POST`</mark> `https://api.convai.com/character/update`

通过现有的 [角色基础 API](https://docs.convai.com/api-docs/zh/api-can-kao/core-api-reference/character-crafting-apis/character-api.md) 更新端点，将一个或多个外部 API 函数关联到角色。关联后（`status: "active"`），模型便可在对话过程中调用这些函数。

一个角色最多可拥有 **128** 个已启用函数。你可以在一次请求中关联多个函数，也可以同时混合关联和 [取消关联](#unlink-functions-from-a-character) 操作。

#### 请求头

| 名称                                              | 类型  | 说明                                         |
| ----------------------------------------------- | --- | ------------------------------------------ |
| CONVAI-API-KEY<mark style="color:红色;">\*</mark> | 字符串 | 为每位用户提供的唯一 API 密钥。登录 Convai 账户后，可在密钥图标下找到。 |
| Content-Type                                    | 字符串 | `application/json`                         |

#### 请求正文

| 名称                                      | 类型  | 说明                                                         |
| --------------------------------------- | --- | ---------------------------------------------------------- |
| charID<mark style="color:红色;">\*</mark> | 字符串 | 要更新的角色。                                                    |
| functions                               | 数组  | 函数配置列表。每个项目都需要包含 `id` （函数 UUID）和 `status` 并设置为 `"active"`. |

#### 示例载荷

```json
{
  "charID": "<character uuid>",
  "functions": [
    {
      "id": "<function uuid>",
      "status": "active"
    }
  ]
}
```

{% tabs %}
{% tab title="200：成功" %}

```json
{
  "STATUS": "SUCCESS"
}
```

{% endtab %}

{% tab title="400：错误请求" %}

```json
{
  "ERROR": "Function limit exceeded. A maximum of 128 functions can be connected to a character.",
  "Reference ID": "<uuid>"
}
```

配置无效时也会返回错误，例如：

* `Functions must be a list of configurations`
* `Missing required fields in function configuration: id`
* `Function status must be one of: active, inactive`
* `Duplicate function ID found: <id>`
  {% endtab %}

{% tab title="401：未授权" %}

```json
{
  "ERROR": "提供的 API 密钥无效。"
}
```

{% endtab %}
{% endtabs %}

以下是一些示例代码，用于演示此端点的请求格式 -->

{% tabs %}
{% tab title="Python" %}
{% code overflow="wrap" %}

```python
import json
import requests

url = "https://api.convai.com/character/update"

payload = json.dumps({
    "charID": "<character uuid>",
    "functions": [
        {"id": "<function uuid>", "status": "active"}
    ]
})
headers = {
    "CONVAI-API-KEY": "<your api key>",
    "Content-Type": "application/json"
}

response = requests.post(url, headers=headers, data=payload)
print(response.text)
```

{% endcode %}
{% endtab %}

{% tab title="cURL" %}
{% code overflow="wrap" %}

```shell
curl --location --request POST 'https://api.convai.com/character/update' \
--header 'CONVAI-API-KEY: <your api key>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "charID": "<character uuid>",
  "functions": [
    {"id": "<function uuid>", "status": "active"}
  ]
}'
```

{% endcode %}
{% endtab %}
{% endtabs %}

关联后，请通过 `/functions/list/` 以及 `character_id` 已设置进行确认——已关联的函数会显示 `"status": "active"`.

***

## 取消角色与函数的关联

<mark style="color:绿色;">`POST`</mark> `https://api.convai.com/character/update`

断开函数与角色的关联，但不会将其从账户中删除。使用与关联相同的端点；将 `status` 设置为 `"inactive"`.

取消关联后，该角色将无法再调用此函数。该函数仍可供日后重新关联，或关联到其他角色。

#### 请求头

| 名称                                              | 类型  | 说明                                         |
| ----------------------------------------------- | --- | ------------------------------------------ |
| CONVAI-API-KEY<mark style="color:红色;">\*</mark> | 字符串 | 为每位用户提供的唯一 API 密钥。登录 Convai 账户后，可在密钥图标下找到。 |
| Content-Type                                    | 字符串 | `application/json`                         |

#### 请求正文

| 名称                                      | 类型  | 说明                                                           |
| --------------------------------------- | --- | ------------------------------------------------------------ |
| charID<mark style="color:红色;">\*</mark> | 字符串 | 要更新的角色。                                                      |
| functions                               | 数组  | 函数配置列表。每个项目都需要包含 `id` （函数 UUID）和 `status` 并设置为 `"inactive"`. |

#### 示例载荷

```json
{
  "charID": "<character uuid>",
  "functions": [
    {
      "id": "<function uuid>",
      "status": "inactive"
    }
  ]
}
```

{% tabs %}
{% tab title="200：成功" %}

```json
{
  "STATUS": "SUCCESS"
}
```

{% endtab %}

{% tab title="400：错误请求" %}

```json
{
  "ERROR": "Missing required fields in function configuration: status",
  "Reference ID": "<uuid>"
}
```

{% endtab %}

{% tab title="401：未授权" %}

```json
{
  "ERROR": "提供的 API 密钥无效。"
}
```

{% endtab %}
{% endtabs %}

以下是一些示例代码，用于演示此端点的请求格式 -->

{% tabs %}
{% tab title="Python" %}
{% code overflow="wrap" %}

```python
import json
import requests

url = "https://api.convai.com/character/update"

payload = json.dumps({
    "charID": "<character uuid>",
    "functions": [
        {"id": "<function uuid>", "status": "inactive"}
    ]
})
headers = {
    "CONVAI-API-KEY": "<your api key>",
    "Content-Type": "application/json"
}

response = requests.post(url, headers=headers, data=payload)
print(response.text)
```

{% endcode %}
{% endtab %}

{% tab title="cURL" %}
{% code overflow="wrap" %}

```shell
curl --location --request POST 'https://api.convai.com/character/update' \
--header 'CONVAI-API-KEY: <your api key>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "charID": "<character uuid>",
  "functions": [
    {"id": "<function uuid>", "status": "inactive"}
  ]
}'
```

{% endcode %}
{% endtab %}
{% endtabs %}

通过 `/functions/list/` 以及 `character_id` 进行确认——未关联的函数会显示 `"status": "inactive"`.

{% hint style="info" %}
取消关联只会移除角色关联。若要彻底从你的账户中删除该函数（以及它关联的所有角色），请使用 [删除函数](#delete-a-function).
{% endhint %}

***

## 删除函数

<mark style="color:绿色;">`POST`</mark> `https://api.convai.com/functions/delete/`

删除你拥有的函数，并移除该函数与所有角色的关联。此操作无法撤销。

#### 请求头

| 名称                                              | 类型  | 说明                                         |
| ----------------------------------------------- | --- | ------------------------------------------ |
| CONVAI-API-KEY<mark style="color:红色;">\*</mark> | 字符串 | 为每位用户提供的唯一 API 密钥。登录 Convai 账户后，可在密钥图标下找到。 |
| Content-Type<mark style="color:红色;">\*</mark>   | 字符串 | 必须为 `application/json`                     |

#### 请求正文

| 名称                                            | 类型  | 说明           |
| --------------------------------------------- | --- | ------------ |
| function\_id<mark style="color:红色;">\*</mark> | 字符串 | 要删除的函数的 UUID |

#### 示例载荷

```json
{
  "function_id": "<function uuid>"
}
```

{% tabs %}
{% tab title="200：成功" %}

```json
{
  "transactionID": "<uuid>",
  "status": "success"
}
```

{% endtab %}

{% tab title="403 Forbidden" %}

```json
{
  "ERROR": "You don't have permission to delete this function",
  "Reference ID": "<uuid>"
}
```

{% endtab %}

{% tab title="404 Not Found" %}

```json
{
  "ERROR": "Function with id <function uuid> not found",
  "Reference ID": "<uuid>"
}
```

{% endtab %}

{% tab title="401：未授权" %}

```json
{
  "ERROR": "提供的 API 密钥无效。"
}
```

{% endtab %}
{% endtabs %}

以下是一些示例代码，用于演示此端点的请求格式 -->

{% tabs %}
{% tab title="Python" %}
{% code overflow="wrap" %}

```python
import json
import requests

url = "https://api.convai.com/functions/delete/"

payload = json.dumps({
    "function_id": "<function uuid>"
})
headers = {
    "CONVAI-API-KEY": "<your api key>",
    "Content-Type": "application/json"
}

response = requests.post(url, headers=headers, data=payload)
print(response.text)
```

{% endcode %}
{% endtab %}

{% tab title="cURL" %}
{% code overflow="wrap" %}

```shell
curl --location --request POST 'https://api.convai.com/functions/delete/' \
--header 'CONVAI-API-KEY: <your api key>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "function_id": "<function uuid>"
}'
```

{% endcode %}
{% endtab %}
{% endtabs %}

{% hint style="info" %}
若要在不删除函数的情况下断开它与角色的关联，请使用 [取消函数与角色的关联](#unlink-functions-from-a-character).
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.convai.com/api-docs/zh/api-can-kao/core-api-reference/character-crafting-apis/external-api.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
