> ## Documentation Index
> Fetch the complete documentation index at: https://docs.somark.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 在 Coze 中使用 SoMark

> 通过 Coze 插件市场将 SoMark 文档解析能力接入智能体与工作流

## Coze 简介

Coze（扣子）是字节跳动推出的零代码 AI 应用开发平台。无论是否有编程经验，都可以通过该平台快速创建聊天机器人、智能体、AI 应用和插件，并将其部署到社交平台与即时通讯应用中。

SoMark 插件已在 Coze 插件商店上线，可为智能体和工作流提供强大的文档解析能力。

## 在智能体中使用 SoMark 插件

<Steps>
  <Step title="创建智能体">进入工作空间，点击 **项目开发** → 右上角 **+ 项目** → 选择 **创建智能体**。 <img src="https://mintcdn.com/soulcode-aa7e5a93/I8QD66YzkFVIEkWW/images/coze-%E5%88%9B%E5%BB%BA%E6%99%BA%E8%83%BD%E4%BD%93.png?fit=max&auto=format&n=I8QD66YzkFVIEkWW&q=85&s=41a9d96df1ff88cd26bc7aafbe77c5e0" alt="coze-创建智能体" width="1851" height="929" data-path="images/coze-创建智能体.png" /></Step>

  <Step title="添加 SoMark 插件">
    在智能体编辑页面，找到 **技能** 区域，点击添加插件。 <img src="https://mintcdn.com/soulcode-aa7e5a93/I8QD66YzkFVIEkWW/images/coze-%E6%B7%BB%E5%8A%A0%E6%8F%92%E4%BB%B6-1.png?fit=max&auto=format&n=I8QD66YzkFVIEkWW&q=85&s=1f78201b3763d477ed5bc925b28bd49b" alt="coze-添加插件-1" width="1851" height="929" data-path="images/coze-添加插件-1.png" /> 在插件搜索框中输入 **somark**，找到并添加 **somark\_doc\_parse** 插件。

    <img src="https://mintcdn.com/soulcode-aa7e5a93/Ha2UCJE-ORRyntwZ/images/coze-%E6%B7%BB%E5%8A%A0%E6%8F%92%E4%BB%B6-2.png?fit=max&auto=format&n=Ha2UCJE-ORRyntwZ&q=85&s=194ca670846badfe2dc926758a0033a1" alt="coze-添加插件-2" width="2994" height="1460" data-path="images/coze-添加插件-2.png" />
  </Step>

  <Step title="配置 API Key">
    在插件参数编辑中，填入您的 SoMark API Key。
    <Note>还没有 API Key？[前往 SoMark API 工作台获取 API Key](https://somark.tech/workbench/apikey)。免费额度无需领取，会自动发放到账户（每日 500 页、每月 2000 页）。</Note>
    <img src="https://mintcdn.com/soulcode-aa7e5a93/Ha2UCJE-ORRyntwZ/images/coze-%E9%85%8D%E7%BD%AEapikey-1.png?fit=max&auto=format&n=Ha2UCJE-ORRyntwZ&q=85&s=06dcd95b3f6c1ae0c07af4c7b3f24ccb" alt="coze-配置apikey-1" width="3024" height="1468" data-path="images/coze-配置apikey-1.png" /> 填写完 API Key 后，点击右侧开关按钮将其设为**默认启用**状态，这样每次请求时将自动使用该 API Key，无需用户手动填写。
  </Step>

  <Step title="配置其他参数">
    除了 API Key，您还可以按需求配置其他可选参数，例如 **输出格式**、**图片返回格式**、**公式返回格式**、**化学结构返回格式**、**表格返回格式**。 您还可以通过 `feature_config`
    控制是否启用**文字跨页拼接**、**表格跨页拼接**、**标题层级识别**、**文中图/表中图返回**、**图片理解**和**保留页眉页脚**等能力。若暂时不确定如何配置，建议先使用默认值，再根据工作流效果逐项微调。
    具体配置说明见下方 **插件参数说明**。 <img src="https://mintcdn.com/soulcode-aa7e5a93/Ha2UCJE-ORRyntwZ/images/coze-%E5%8F%82%E6%95%B0.png?fit=max&auto=format&n=Ha2UCJE-ORRyntwZ&q=85&s=94bacbed2e83c770986beca4a37ce86b" alt="coze-参数" width="3000" height="1446" data-path="images/coze-参数.png" />
  </Step>

  <Step title="保存并测试">
    点击**保存**，即可在智能体中使用 SoMark 文档解析功能。在对话中上传文件后，可以看到「正在调用 somark」的提示，解析完成后结果将直接返回。

    <img src="https://mintcdn.com/soulcode-aa7e5a93/I8QD66YzkFVIEkWW/images/coze-%E6%B5%8B%E8%AF%95%E8%B0%83%E7%94%A8.png?fit=max&auto=format&n=I8QD66YzkFVIEkWW&q=85&s=be59e388962bd9186a2fdeb92c00417d" alt="coze-测试调用" width="1851" height="929" data-path="images/coze-测试调用.png" />
  </Step>
</Steps>

## 插件参数说明

| 参数                | 类型     | 必填 | 说明                                                            |
| ----------------- | ------ | -- | ------------------------------------------------------------- |
| `file`            | file   | ✅  | 待解析的文件，支持 PDF、图片、Word、PPT 和 Excel 格式                          |
| `api_key`         | string | ✅  | API 密钥，格式为 `sk-***`                                           |
| `output_formats`  | array  | ❌  | 输出格式，可多选。不传时默认为 `["markdown", "json"]`。支持 `json` 和 `markdown` |
| `element_formats` | object | ❌  | 元素格式配置，用于控制图片、公式、表格和化学结构式的返回格式                                |
| `feature_config`  | object | ❌  | 特色功能配置。该参数已从 `extract_config` 更名为 `feature_config`            |

<AccordionGroup>
  <Accordion title="element_formats">
    | 字段        | 类型     | 说明                                     |
    | --------- | ------ | -------------------------------------- |
    | `image`   | string | 图片返回格式。支持 `url`、`base64`、`file`、`none` |
    | `formula` | string | 公式返回格式。支持 `latex`、`mathml`、`ascii`     |
    | `table`   | string | 表格返回格式。支持 `markdown`、`html`、`image`    |
    | `cs`      | string | 化学结构式返回格式。当前支持 `image`                 |
  </Accordion>

  <Accordion title="feature_config" defaultOpen>
    | 字段                               | 类型      | 说明                             |
    | -------------------------------- | ------- | ------------------------------ |
    | `enable_text_cross_page`         | boolean | 是否启用文字跨页拼接，支持 `true` / `false` |
    | `enable_table_cross_page`        | boolean | 是否启用表格跨页拼接，支持 `true` / `false` |
    | `enable_title_level_recognition` | boolean | 是否启用标题层级识别，支持 `true` / `false` |
    | `enable_inline_image`            | boolean | 是否返回文中图片，支持 `true` / `false`   |
    | `enable_table_image`             | boolean | 是否返回表中图片，支持 `true` / `false`   |
    | `enable_image_understanding`     | boolean | 是否启用图片理解，支持 `true` / `false`   |
    | `keep_header_footer`             | boolean | 是否保留页眉页脚，支持 `true` / `false`   |
  </Accordion>
</AccordionGroup>