#7735·chroma

[DOC] `Collection.add`/`query` 文档说明中列出了客户端永远不会引发的 ValueErrors

作者: siddharthgaur1创建于 2026年9月13日更新于 2026年9月13日

Raises: ' collection.add'和collection.query'两节(以及Async Collection'中的同文)描述了chromadb 1.5.9没有引起的三个错误。 生成的参考页`Reference/Python/collection.mdx'重复了这些内容,在三种情况下中,有两种情况是用户指南已经说相反的。

校对:Soup |. ‘add':"ValueError:如果ID已经存在". 无出错. 保存现有记录并撤销新的记录。 |'add-data.mdx:182':"它不会被忽略而不扔出错误"|". +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 接受,两者均已储存。 `types.py'明确允许文档与嵌入相并用。 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ QQ'query':"ValueError:如果提供了多个查询输入类型". 无出错. 有了“query-embeddings”和“query-texts”两个字,就使用了嵌入法,忽略了文本。 - | - |

所有三种繁殖方式都带有 " EphemeralClient " 和 " HttpClient " 来对抗 " Chroma跑 " 。 现有的IDadd'和query'案也与`AsyncHttpClient'相呼应。

□再现.

[Python] 导入克罗马德b

col = chromadb. EphemeralClient (.) 创建 collection ("repro",嵌入 函数=无) e = [[0.1、0.2、0.3]]]

col.add(ids=["a"],嵌入s=e,文档=["第一"]). col.add(ids=["a"],嵌入式=[[0.9,0.9]]],文档=["秒"])# 有文件可提出 print(col.get(ids= ["a"] ["文档"]) # ['first']

col.add(ids= ["b"], 嵌入=e, 文档= ["doc"]) # 有文件可提出; 已接受

print(col.query (query embeddings=e,查询 texts= ["无关"],n results=1 ["ids"]) # 有文件可提出; 文本被忽略


# 何处 #

- `chromadb/api/models/Collection.py':`add' 抬起( " main " 第122行,124行),`query ' 抬起(268行)
- `chromadb/api/models/AsyncCollection.py':`add' Lagas (84-85)、`query' Lagas (249-251)
- `docs/mintlify/Reference/Python/collection.mdx':由`docs/scripts/generate python Reference.py'产生。

□ 版本数

chromadb 1.5.9 (pyPI上的最新数据),Python 3.11.6,Windows 11. 线路编号取自"main" at a7920e9.

□ 建议的固定

对于 " 添加 " ,行为与指南相匹配,因此只有指针是错误的:放出两行并声明忽略了现有的ID,指向 " upsert " / " 更新 " 。 然后再生`collection.mdx'。

`克瑞'不太明确。 静静地忽略了嵌入器也通过时的‘query texts'很容易被错过,因此它可以是指针固定,也可以是真正的检查. 现在的升起会打破今天两个都通过的人。 你喜欢哪一个?

我可以打开一个公关 对于剂量的改变.

内容来源: chroma-core/chroma