AIGility ADK - Agent Development Kit
基于 LangGraph/LangChain 的智能体开发框架,提供开箱即用的 RAG、记忆管理、对话流等能力。
特性
-
RAG 检索增强生成
- 基础 RAG 服务:文档摄取、向量化、语义检索
- 工作流模式 RAG:基于 LangGraph 的可组合 RAG 工作流
- 多 Embedding 支持:DashScope、HuggingFace 等
- 多向量存储支持:Chroma、FAISS、Milvus 等
-
记忆管理
- 持久化对话历史
- 语义记忆检索
- 可扩展的记忆存储
-
对话流管理
- 基于 LangGraph 的对话流编排
- 工具调用支持
- 状态管理
-
工作流引擎
- 可视化工作流构建
- 节点编排
- 条件分支和循环
安装
核心安装(推荐)
只安装核心依赖,包含聊天、工作流、内存管理等基础功能:
pip install aigility
完整安装
如需使用 RAG、向量存储、文档处理等高级功能:
# 安装所有可选功能
pip install "aigility[all]"
# 或者只安装需要的模块
pip install "aigility[rag-local]" # 本地 RAG (HuggingFace + Chroma)
pip install "aigility[rag-qdrant]" # Qdrant RAG
pip install "aigility[timem]" # 太忆 RAG 服务
pip install "aigility[anthropic]" # Anthropic LLM 支持
可选功能模块
| 模块 | 说明 | 安装命令 |
|---|---|---|
anthropic |
Anthropic Claude 支持 | pip install "aigility[anthropic]" |
rag-local |
本地 RAG (HuggingFace + Chroma) | pip install "aigility[rag-local]" |
rag-qdrant |
Qdrant RAG | pip install "aigility[rag-qdrant]" |
timem |
太忆 RAG 服务 | pip install "aigility[timem]" |
timem-rag |
太忆 RAG 完整功能 (含文档处理) | pip install "aigility[timem-rag]" |
zai |
在智 embedding 服务 | pip install "aigility[zai]" |
all |
所有功能 | pip install "aigility[all]" |
注意:rag-local 会下载 HuggingFace 模型(约 500MB-2GB),安装时间较长
快速开始
RAG 基础使用
from aigility.rag import RAGService, RAGConfig, EmbeddingConfig, VectorStoreConfig
# 配置 RAG 服务
config = RAGConfig(
embedding=EmbeddingConfig(provider="dashscope", api_key="your-api-key"),
vector_store=VectorStoreConfig(provider="chroma", persist_path="./my_db")
)
# 初始化服务
rag_service = RAGService(config=config)
# 添加文档
rag_service.add_file("document.pdf")
# 检索相关内容
results = rag_service.search("什么是机器学习?")
print(results)
RAG 工作流模式
from aigility.rag import RAGService, create_rag_workflow
from langchain_openai import ChatOpenAI
# 初始化 RAG 服务和 LLM
rag_service = RAGService()
llm = ChatOpenAI(model="gpt-4")
# 创建工作流
workflow = create_rag_workflow(rag_service, llm)
# 执行查询
result = workflow.invoke({
"query": "什么是机器学习?",
"messages": []
})
print(result["answer"])
客户端使用
from aigility import ADKClient, create_client
# 创建客户端
client = create_client(
llm_provider="openai",
llm_api_key="your-api-key",
memory_api_key="your-memory-api-key",
)
# 使用记忆
memory = client.memory
await memory.add(
messages=[{"role": "user", "content": "Hello"}],
user_id="user123",
character_id="assistant"
)
# 创建对话智能体
agent = client.create_chat_agent(name="my_agent")
文档
项目结构
aigility/
├── core/ # 核心配置和类型
├── memory/ # 记忆管理
├── chat/ # 基础对话
├── chatflow/ # 对话流管理
├── workflow/ # 工作流引擎
├── rag/ # RAG 检索增强生成
│ ├── service.py # RAG 服务
│ ├── workflow.py # RAG 工作流
│ ├── embeddings/ # Embedding 模型
│ ├── vector_stores/ # 向量存储
│ └── ingestion.py # 文档摄取
├── adp/ # ADP 服务客户端
└── client.py # 主客户端
技术栈
- LangChain: 基础对话能力
- LangGraph: 对话流和工作流编排
- Chroma/FAISS/Milvus: 向量存储
- DashScope/HuggingFace: Embedding 模型
许可证
MIT License
Metadata
Release files for aigility 0.1.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| aigility-0.1.5.tar.gz | 85.7 kB | Without provenance | Details for aigility-0.1.5.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| aigility-0.1.5-py3-none-any.whl | Python 3 | none | any | Details for aigility-0.1.5-py3-none-any.whl |
Total release size: 191.7 kB
Release files / aigility-0.1.5.tar.gz
| Download URL | aigility-0.1.5.tar.gz |
|---|---|
| Size | 85.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
58f7e6bfb3532c58aa2c2a02b9c96375540633fc86ddf98956298d3fe23b5f44
|
|
BLAKE2b-256 checksum How to use checksums |
fd8f9c259262f2b3664a917799fce16009ab8bc430a0e5223876ae4051bcc55a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
Release files / aigility-0.1.5-py3-none-any.whl
| Download URL | aigility-0.1.5-py3-none-any.whl |
|---|---|
| Size | 106.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3e2813887b9907031083506fd8abc2270589389cfde07c1857045944c548426b
|
|
BLAKE2b-256 checksum How to use checksums |
c3a23f1a2cec889bea232e39602d77bb0dbdcc759270d427dcdb372e5d8bb7b6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
Security for aigility 0.1.5
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.