agentscope-ai/agentscope-java

[Bug]:OpenAITextEmbedding 组件存在设计缺陷

Open

#1095 opened on Apr 1, 2026

View on GitHub
 (1 comment) (0 reactions) (0 assignees)Java (3,253 stars) (693 forks)user submission
buggood first issue

Description

OpenAITextEmbedding 组件存在设计缺陷：强制要求传入 dimensions 向量维度参数，并默认携带该参数调用接口，未区分模型兼容性。 该参数仅 OpenAI 官方嵌入模型支持，BAAI/bge 等开源嵌入模型不支持 matryoshka representation 嵌套向量功能，携带 dimensions 调用会直接返回 400 错误，导致开源模型无法使用。 复现方式 使用 OpenAITextEmbedding 调用开源嵌入模型（如 BAAI/bge-large-zh-v1.5），框架自动携带 dimensions 参数，接口报错： Model "BAAI/bge-large-zh-v1.5" does not support matryoshka representation... 影响范围 所有非 OpenAI 官方嵌入模型均无法通过 OpenAITextEmbedding 正常调用，严重限制框架对开源嵌入模型的支持。 修复建议 将 dimensions 改为非必选参数，默认不传递； 仅当用户显式配置时，才携带该参数； 增加模型兼容性判断，仅对 OpenAI 官方模型支持 dimensions 配置。

Contributor guide

Tech stack
javarest api
Domain
backendai
Issue type
bug
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
mostly clear
Prerequisites
Java knowledgeUnderstanding of embedding models and API
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
50
Research direction
Investigate the OpenAITextEmbedding component in the repository, likely in the source code under a package like 'embedding'. The goal is to make the 'dimensions' parameter optional, and only pass it when the user explicitly configures it. Additionally, add a check to determine if the model supports the dimensions parameter (e.g., only for OpenAI models). Look at the existing request construction logic and the API client used to send requests to the embedding endpoint. Ensure backward compatibility and update documentation accordingly.