Metadata-Version: 2.5
Name: zero-agent-core-embeddings
Version: 0.1.2
Summary: Zero Agent Core 的 Embedding Provider 扩展
Project-URL: Homepage, https://github.com/qiuzixu/agent-core
Project-URL: Repository, https://github.com/qiuzixu/agent-core
License-Expression: Apache-2.0
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Python: <3.14,>=3.13
Requires-Dist: zero-agent-core<0.3,>=0.2.1
Provides-Extra: all
Requires-Dist: google-genai<2,>=1.0; extra == 'all'
Requires-Dist: httpx<1,>=0.28; extra == 'all'
Requires-Dist: openai<2,>=1.0; extra == 'all'
Provides-Extra: dev
Requires-Dist: mypy<2,>=1.18; extra == 'dev'
Requires-Dist: pytest-asyncio<2,>=1.3; extra == 'dev'
Requires-Dist: pytest<10,>=9; extra == 'dev'
Requires-Dist: ruff<1,>=0.14; extra == 'dev'
Provides-Extra: gemini
Requires-Dist: google-genai<2,>=1.0; extra == 'gemini'
Provides-Extra: ollama
Requires-Dist: httpx<1,>=0.28; extra == 'ollama'
Provides-Extra: openai
Requires-Dist: openai<2,>=1.0; extra == 'openai'
Description-Content-Type: text/markdown

# Zero Agent Core Embeddings

`zero-agent-core-embeddings` 为 Agent Core 的 `Embeddings` 协议提供 OpenAI、Gemini 和
Ollama 实现。Core 的 Retriever 和 VectorStore 不依赖任何厂商 SDK。

```bash
pip install "zero-agent-core-embeddings[openai]"
pip install "zero-agent-core-embeddings[gemini]"
pip install "zero-agent-core-embeddings[ollama]"
```

```python
from agent_core_embeddings import OpenAIEmbeddings

embeddings = OpenAIEmbeddings(
    api_key="从安全配置读取",
    model="text-embedding-3-small",
)
vectors = await embeddings.embed_documents(["第一段", "第二段"])
query_vector = await embeddings.embed_query("查询内容")
```

三个适配器共享批处理、并发、有限重试、超时、有限值和维度校验。API Key 和模型选择由应用配置，
扩展包不读取 `.env`。
