Skip to content

5. 基础组件配置

Jump to bottom
fanlv edited this page Mar 16, 2026 · 6 revisions

部署 Coze Studio 开源版之后，如需使用图片上传功能，或知识库相关功能，应参考本文档配置功能相关的基础组件。这些组件通常依赖火山引擎等第三方服务，配置组件时需要填写第三方服务的账号密钥等鉴权配置。

上传组件

在多模态对话场景，往往需要在对话中上传图片、文件等信息，例如在智能体调试区域中发送图片消息：

Image

此功能由上传组件提供。Coze Studio 上传组件目前支持以下三种，你可以任选一种作为上传组件。

  • （默认）minio：图片和文件自动上传至本地主机的 minio 服务，通过指定端口号可访问。但本地主机必须配置公网域名，否则已上传的图片和文件只能生成内网访问链接，无法被大模型读取和识别。
  • 火山引擎对象存储 TOS：图片和文件自动上传至指定的火山引擎对象存储 TOS 服务，并生成一个公网可访问的 URL。如果选择 TOS，必须先开通 TOS 并在 Coze Studio 中配置火山密钥。
  • 火山引擎 ImageX：图片和文件自动上传至指定的火山引擎 ImageX，并生成一个公网可访问的 URL。如果选择 ImageX，必须先开通 ImageX 并在 Coze Studio 中配置火山密钥。

上传组件的配置方式如下：

  1. 设置上传组件类型。 在 docker 目录中打开 .env 文件，配置项 "FILE_UPLOAD_COMPONENT_TYPE" 的值表示上传组件类型。

    • storage（默认）：表示使用STORAGE_TYPE 配置的存储组件，STORAGE_TYPE 默认为 minio，也支持配置为 tos。
    • imagex：表示使用火山 ImageX 组件。
    # This Upload component used in Agent / workflow File/Image With LLM  , support the component of imagex / storage
# default: storage, use the settings of storage component
# if imagex, you must finish the configuration of <VolcEngine ImageX> 
export FILE_UPLOAD_COMPONENT_TYPE="storage"

  2. 为上传组件添加秘钥等配置。 同样在 docker 目录的 .env 文件中，根据组件类型填写以下配置。

    组件类型 配置方式 示例
    minio
    （默认）    		 1. 在 Coze studio 项目的 docker/.env 文件中，FILE_UPLOAD_COMPONENT_TYPE 设置为 storage。
    2. 在 Storage component 区域，设置 STORAGE_TYPE 为 minio。
    3. 在 MiniO 区域，维持默认配置即可。

    如果你选择在火山引擎等公共云上部署 Coze Studio，则需要提前为你的云服务器开放 8888、8889 端口的访问权限。
    		Image
    tos 1. 开通火山引擎 TOS 产品。
    2. 在 Coze studio 项目的 docker/.env 文件中，FILE_UPLOAD_COMPONENT_TYPE 设置为 storage。
    3. 在 Storage component 区域，设置 STORAGE_TYPE 为 tos。
    4. 在 TOS 区域，填写以下参数：
    * TOS_ACCESS_KEY：火山引擎密钥 AK。获取方式可参考获取火山引擎 API 密钥。
    * TOS_SECRET_KEY：火山引擎密钥 SK。获取方式可参考获取火山引擎 API 密钥。
    * TOS_ENDPOINT：TOS 服务的 Endpoint，获取方式可参考地域和访问域名。
    * TOS_REGION：TOS 服务所在的地域，获取方式可参考地域和访问域名。
    Image
    imagex 1. 开通火山引擎 veImageX 产品，并创建素材托管服务。操作步骤可参考火山 veImageX 官方文档。注意创建素材托管服务时需要填写域名，建议提前获取一个可用的公开域名。
    2. 在 Coze studio 项目的 docker/.env 文件中，FILE_UPLOAD_COMPONENT_TYPE 设置为 imagex。
    3. 在 VolcEngine ImageX 区域，填写以下参数：
    * VE_IMAGEX_AK：火山引擎密钥 AK。获取方式可参考获取火山引擎 API 密钥。
    * VE_IMAGEX_SK：火山引擎密钥 SK。获取方式可参考获取火山引擎 API 密钥。
    * VE_IMAGEX_SERVER_ID：火山引擎 veImageX 产品服务管理页面展示的服务 ID。
    * VE_IMAGEX_DOMAIN：创建服务时指定的域名。
    * VE_IMAGEX_TEMPLATE：图片处理配置的模板名称。
    Image

  3. 执行以下命令重启服务，使以上配置生效。

    docker compose --profile '*' up -d --force-recreate --no-deps coze-server

其他组件配置，请访问 http://localhost:8888/admin/ 配置。

Home

Clone this wiki locally