agentscope-ai/agentscope-java

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

Aberta

#1.095 aberto em 1 de abr. de 2026

Ver no GitHubGuia do colaborador
 (3 comentários) (0 reação) (1 responsável)Java (693 forks)user submission
area/ext/ragbuggood first issue

Métricas do repositório

Stars
 (3.253 estrelas)
Métricas de merge de PR
 (Mesclagem média 2d 8h) (58 fundiu PRs em 30d)

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 配置。

Guia do colaborador

Direção de pesquisa
Torne o parâmetro dimensions opcional no OpenAITextEmbedding e adicione detecção de compatibilidade de modelo para incluí lo apenas para modelos oficiais da OpenAI.
Pilha de tecnologia
java
Domain
backend
Tipo Issue
Bug
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
2
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
1-3 horas
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Ativo
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Claro
Prerequisites
JavaGit
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
75