LightAgent 0.1.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- lightagent-0.1.0/LICENSE +201 -0
- lightagent-0.1.0/PKG-INFO +4 -0
- lightagent-0.1.0/README.md +168 -0
- lightagent-0.1.0/pyproject.toml +51 -0
- lightagent-0.1.0/setup.cfg +4 -0
- lightagent-0.1.0/src/LightAgent.egg-info/PKG-INFO +4 -0
- lightagent-0.1.0/src/LightAgent.egg-info/SOURCES.txt +9 -0
- lightagent-0.1.0/src/LightAgent.egg-info/dependency_links.txt +1 -0
- lightagent-0.1.0/src/LightAgent.egg-info/top_level.txt +2 -0
- lightagent-0.1.0/src/__init__.py +3 -0
- lightagent-0.1.0/src/la_core.py +225 -0
lightagent-0.1.0/LICENSE
ADDED
|
@@ -0,0 +1,201 @@
|
|
|
1
|
+
Apache License
|
|
2
|
+
Version 2.0, January 2004
|
|
3
|
+
http://www.apache.org/licenses/
|
|
4
|
+
|
|
5
|
+
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
|
|
6
|
+
|
|
7
|
+
1. Definitions.
|
|
8
|
+
|
|
9
|
+
"License" shall mean the terms and conditions for use, reproduction,
|
|
10
|
+
and distribution as defined by Sections 1 through 9 of this document.
|
|
11
|
+
|
|
12
|
+
"Licensor" shall mean the copyright owner or entity authorized by
|
|
13
|
+
the copyright owner that is granting the License.
|
|
14
|
+
|
|
15
|
+
"Legal Entity" shall mean the union of the acting entity and all
|
|
16
|
+
other entities that control, are controlled by, or are under common
|
|
17
|
+
control with that entity. For the purposes of this definition,
|
|
18
|
+
"control" means (i) the power, direct or indirect, to cause the
|
|
19
|
+
direction or management of such entity, whether by contract or
|
|
20
|
+
otherwise, or (ii) ownership of fifty percent (50%) or more of the
|
|
21
|
+
outstanding shares, or (iii) beneficial ownership of such entity.
|
|
22
|
+
|
|
23
|
+
"You" (or "Your") shall mean an individual or Legal Entity
|
|
24
|
+
exercising permissions granted by this License.
|
|
25
|
+
|
|
26
|
+
"Source" form shall mean the preferred form for making modifications,
|
|
27
|
+
including but not limited to software source code, documentation
|
|
28
|
+
source, and configuration files.
|
|
29
|
+
|
|
30
|
+
"Object" form shall mean any form resulting from mechanical
|
|
31
|
+
transformation or translation of a Source form, including but
|
|
32
|
+
not limited to compiled object code, generated documentation,
|
|
33
|
+
and conversions to other media types.
|
|
34
|
+
|
|
35
|
+
"Work" shall mean the work of authorship, whether in Source or
|
|
36
|
+
Object form, made available under the License, as indicated by a
|
|
37
|
+
copyright notice that is included in or attached to the work
|
|
38
|
+
(an example is provided in the Appendix below).
|
|
39
|
+
|
|
40
|
+
"Derivative Works" shall mean any work, whether in Source or Object
|
|
41
|
+
form, that is based on (or derived from) the Work and for which the
|
|
42
|
+
editorial revisions, annotations, elaborations, or other modifications
|
|
43
|
+
represent, as a whole, an original work of authorship. For the purposes
|
|
44
|
+
of this License, Derivative Works shall not include works that remain
|
|
45
|
+
separable from, or merely link (or bind by name) to the interfaces of,
|
|
46
|
+
the Work and Derivative Works thereof.
|
|
47
|
+
|
|
48
|
+
"Contribution" shall mean any work of authorship, including
|
|
49
|
+
the original version of the Work and any modifications or additions
|
|
50
|
+
to that Work or Derivative Works thereof, that is intentionally
|
|
51
|
+
submitted to Licensor for inclusion in the Work by the copyright owner
|
|
52
|
+
or by an individual or Legal Entity authorized to submit on behalf of
|
|
53
|
+
the copyright owner. For the purposes of this definition, "submitted"
|
|
54
|
+
means any form of electronic, verbal, or written communication sent
|
|
55
|
+
to the Licensor or its representatives, including but not limited to
|
|
56
|
+
communication on electronic mailing lists, source code control systems,
|
|
57
|
+
and issue tracking systems that are managed by, or on behalf of, the
|
|
58
|
+
Licensor for the purpose of discussing and improving the Work, but
|
|
59
|
+
excluding communication that is conspicuously marked or otherwise
|
|
60
|
+
designated in writing by the copyright owner as "Not a Contribution."
|
|
61
|
+
|
|
62
|
+
"Contributor" shall mean Licensor and any individual or Legal Entity
|
|
63
|
+
on behalf of whom a Contribution has been received by Licensor and
|
|
64
|
+
subsequently incorporated within the Work.
|
|
65
|
+
|
|
66
|
+
2. Grant of Copyright License. Subject to the terms and conditions of
|
|
67
|
+
this License, each Contributor hereby grants to You a perpetual,
|
|
68
|
+
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
|
69
|
+
copyright license to reproduce, prepare Derivative Works of,
|
|
70
|
+
publicly display, publicly perform, sublicense, and distribute the
|
|
71
|
+
Work and such Derivative Works in Source or Object form.
|
|
72
|
+
|
|
73
|
+
3. Grant of Patent License. Subject to the terms and conditions of
|
|
74
|
+
this License, each Contributor hereby grants to You a perpetual,
|
|
75
|
+
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
|
76
|
+
(except as stated in this section) patent license to make, have made,
|
|
77
|
+
use, offer to sell, sell, import, and otherwise transfer the Work,
|
|
78
|
+
where such license applies only to those patent claims licensable
|
|
79
|
+
by such Contributor that are necessarily infringed by their
|
|
80
|
+
Contribution(s) alone or by combination of their Contribution(s)
|
|
81
|
+
with the Work to which such Contribution(s) was submitted. If You
|
|
82
|
+
institute patent litigation against any entity (including a
|
|
83
|
+
cross-claim or counterclaim in a lawsuit) alleging that the Work
|
|
84
|
+
or a Contribution incorporated within the Work constitutes direct
|
|
85
|
+
or contributory patent infringement, then any patent licenses
|
|
86
|
+
granted to You under this License for that Work shall terminate
|
|
87
|
+
as of the date such litigation is filed.
|
|
88
|
+
|
|
89
|
+
4. Redistribution. You may reproduce and distribute copies of the
|
|
90
|
+
Work or Derivative Works thereof in any medium, with or without
|
|
91
|
+
modifications, and in Source or Object form, provided that You
|
|
92
|
+
meet the following conditions:
|
|
93
|
+
|
|
94
|
+
(a) You must give any other recipients of the Work or
|
|
95
|
+
Derivative Works a copy of this License; and
|
|
96
|
+
|
|
97
|
+
(b) You must cause any modified files to carry prominent notices
|
|
98
|
+
stating that You changed the files; and
|
|
99
|
+
|
|
100
|
+
(c) You must retain, in the Source form of any Derivative Works
|
|
101
|
+
that You distribute, all copyright, patent, trademark, and
|
|
102
|
+
attribution notices from the Source form of the Work,
|
|
103
|
+
excluding those notices that do not pertain to any part of
|
|
104
|
+
the Derivative Works; and
|
|
105
|
+
|
|
106
|
+
(d) If the Work includes a "NOTICE" text file as part of its
|
|
107
|
+
distribution, then any Derivative Works that You distribute must
|
|
108
|
+
include a readable copy of the attribution notices contained
|
|
109
|
+
within such NOTICE file, excluding those notices that do not
|
|
110
|
+
pertain to any part of the Derivative Works, in at least one
|
|
111
|
+
of the following places: within a NOTICE text file distributed
|
|
112
|
+
as part of the Derivative Works; within the Source form or
|
|
113
|
+
documentation, if provided along with the Derivative Works; or,
|
|
114
|
+
within a display generated by the Derivative Works, if and
|
|
115
|
+
wherever such third-party notices normally appear. The contents
|
|
116
|
+
of the NOTICE file are for informational purposes only and
|
|
117
|
+
do not modify the License. You may add Your own attribution
|
|
118
|
+
notices within Derivative Works that You distribute, alongside
|
|
119
|
+
or as an addendum to the NOTICE text from the Work, provided
|
|
120
|
+
that such additional attribution notices cannot be construed
|
|
121
|
+
as modifying the License.
|
|
122
|
+
|
|
123
|
+
You may add Your own copyright statement to Your modifications and
|
|
124
|
+
may provide additional or different license terms and conditions
|
|
125
|
+
for use, reproduction, or distribution of Your modifications, or
|
|
126
|
+
for any such Derivative Works as a whole, provided Your use,
|
|
127
|
+
reproduction, and distribution of the Work otherwise complies with
|
|
128
|
+
the conditions stated in this License.
|
|
129
|
+
|
|
130
|
+
5. Submission of Contributions. Unless You explicitly state otherwise,
|
|
131
|
+
any Contribution intentionally submitted for inclusion in the Work
|
|
132
|
+
by You to the Licensor shall be under the terms and conditions of
|
|
133
|
+
this License, without any additional terms or conditions.
|
|
134
|
+
Notwithstanding the above, nothing herein shall supersede or modify
|
|
135
|
+
the terms of any separate license agreement you may have executed
|
|
136
|
+
with Licensor regarding such Contributions.
|
|
137
|
+
|
|
138
|
+
6. Trademarks. This License does not grant permission to use the trade
|
|
139
|
+
names, trademarks, service marks, or product names of the Licensor,
|
|
140
|
+
except as required for reasonable and customary use in describing the
|
|
141
|
+
origin of the Work and reproducing the content of the NOTICE file.
|
|
142
|
+
|
|
143
|
+
7. Disclaimer of Warranty. Unless required by applicable law or
|
|
144
|
+
agreed to in writing, Licensor provides the Work (and each
|
|
145
|
+
Contributor provides its Contributions) on an "AS IS" BASIS,
|
|
146
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
|
147
|
+
implied, including, without limitation, any warranties or conditions
|
|
148
|
+
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
|
|
149
|
+
PARTICULAR PURPOSE. You are solely responsible for determining the
|
|
150
|
+
appropriateness of using or redistributing the Work and assume any
|
|
151
|
+
risks associated with Your exercise of permissions under this License.
|
|
152
|
+
|
|
153
|
+
8. Limitation of Liability. In no event and under no legal theory,
|
|
154
|
+
whether in tort (including negligence), contract, or otherwise,
|
|
155
|
+
unless required by applicable law (such as deliberate and grossly
|
|
156
|
+
negligent acts) or agreed to in writing, shall any Contributor be
|
|
157
|
+
liable to You for damages, including any direct, indirect, special,
|
|
158
|
+
incidental, or consequential damages of any character arising as a
|
|
159
|
+
result of this License or out of the use or inability to use the
|
|
160
|
+
Work (including but not limited to damages for loss of goodwill,
|
|
161
|
+
work stoppage, computer failure or malfunction, or any and all
|
|
162
|
+
other commercial damages or losses), even if such Contributor
|
|
163
|
+
has been advised of the possibility of such damages.
|
|
164
|
+
|
|
165
|
+
9. Accepting Warranty or Additional Liability. While redistributing
|
|
166
|
+
the Work or Derivative Works thereof, You may choose to offer,
|
|
167
|
+
and charge a fee for, acceptance of support, warranty, indemnity,
|
|
168
|
+
or other liability obligations and/or rights consistent with this
|
|
169
|
+
License. However, in accepting such obligations, You may act only
|
|
170
|
+
on Your own behalf and on Your sole responsibility, not on behalf
|
|
171
|
+
of any other Contributor, and only if You agree to indemnify,
|
|
172
|
+
defend, and hold each Contributor harmless for any liability
|
|
173
|
+
incurred by, or claims asserted against, such Contributor by reason
|
|
174
|
+
of your accepting any such warranty or additional liability.
|
|
175
|
+
|
|
176
|
+
END OF TERMS AND CONDITIONS
|
|
177
|
+
|
|
178
|
+
APPENDIX: How to apply the Apache License to your work.
|
|
179
|
+
|
|
180
|
+
To apply the Apache License to your work, attach the following
|
|
181
|
+
boilerplate notice, with the fields enclosed by brackets "[]"
|
|
182
|
+
replaced with your own identifying information. (Don't include
|
|
183
|
+
the brackets!) The text should be enclosed in the appropriate
|
|
184
|
+
comment syntax for the file format. We also recommend that a
|
|
185
|
+
file or class name and description of purpose be included on the
|
|
186
|
+
same "printed page" as the copyright notice for easier
|
|
187
|
+
identification within third-party archives.
|
|
188
|
+
|
|
189
|
+
Copyright 2024 LangChain-Chatchat Team
|
|
190
|
+
|
|
191
|
+
Licensed under the Apache License, Version 2.0 (the "License");
|
|
192
|
+
you may not use this file except in compliance with the License.
|
|
193
|
+
You may obtain a copy of the License at
|
|
194
|
+
|
|
195
|
+
http://www.apache.org/licenses/LICENSE-2.0
|
|
196
|
+
|
|
197
|
+
Unless required by applicable law or agreed to in writing, software
|
|
198
|
+
distributed under the License is distributed on an "AS IS" BASIS,
|
|
199
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
200
|
+
See the License for the specific language governing permissions and
|
|
201
|
+
limitations under the License.
|
|
@@ -0,0 +1,168 @@
|
|
|
1
|
+
# LightAgent
|
|
2
|
+
|
|
3
|
+
**LightAgent** 是一个极其轻量的带记忆(`mem0`)、工具(`Tools`)、思维树(`ToT`)的主动式 Agent 框架。它支持类 Swarm 的多智能体协同、自动化工具生成、Agent 测评,底层模型支持 OpenAI、智谱 ChatGLM、百川大模型、DeepSeek、Qwen 系列大模型等。同时,LightAgent 支持 OpenAI 流格式 API 服务输出,无缝接入各大主流 Chat 框架。
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## 特性
|
|
8
|
+
|
|
9
|
+
- **轻量高效**:极简设计,快速部署,适合各种规模的应用场景。
|
|
10
|
+
- **记忆支持**:内置 `mem0` 记忆模块,支持上下文记忆和历史记录管理。
|
|
11
|
+
- **工具集成**:支持自定义工具(`Tools`),自动化工具生成,灵活扩展。
|
|
12
|
+
- **思维树(ToT)**:内置思维树模块,支持复杂任务分解和多步推理。
|
|
13
|
+
- **多智能体协同**:支持类 Swarm 的多智能体协同工作,提升任务处理效率。
|
|
14
|
+
- **多模型支持**:兼容 OpenAI、智谱 ChatGLM、百川大模型、DeepSeek、Qwen 系列大模型。
|
|
15
|
+
- **流式 API**:支持 OpenAI 流格式 API 服务输出,无缝接入主流 Chat 框架。
|
|
16
|
+
- **Agent 测评**:内置 Agent 测评工具,方便评估和优化 Agent 性能。
|
|
17
|
+
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
## 快速开始
|
|
21
|
+
|
|
22
|
+
### 安装
|
|
23
|
+
|
|
24
|
+
```bash
|
|
25
|
+
pip install lightagent
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
### 示例代码
|
|
29
|
+
|
|
30
|
+
```python
|
|
31
|
+
from lightagent import LightAgent
|
|
32
|
+
|
|
33
|
+
# 初始化 Agent
|
|
34
|
+
agent = LightAgent(model="openai", api_key="your_api_key")
|
|
35
|
+
|
|
36
|
+
# 定义工具
|
|
37
|
+
def search_news(query: str, top_k: int) -> str:
|
|
38
|
+
"""
|
|
39
|
+
实时检索互联网上的信息
|
|
40
|
+
:param query: 检索信息
|
|
41
|
+
:param top_k: 返回条数
|
|
42
|
+
:return: 检索结果
|
|
43
|
+
"""
|
|
44
|
+
return f"检索结果: {query}, top_k: {top_k}"
|
|
45
|
+
|
|
46
|
+
# 注册工具
|
|
47
|
+
agent.register_tool(search_news)
|
|
48
|
+
|
|
49
|
+
# 运行 Agent
|
|
50
|
+
response = agent.run("请搜索最近关于大模型技术的新闻", tools=["search_news"])
|
|
51
|
+
print(response)
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
---
|
|
55
|
+
|
|
56
|
+
## 功能详解
|
|
57
|
+
|
|
58
|
+
### 1. 记忆模块(`mem0`)
|
|
59
|
+
LightAgent 内置 `mem0` 记忆模块,支持上下文记忆和历史记录管理。通过记忆模块,Agent 可以在多轮对话中保持上下文一致性。
|
|
60
|
+
|
|
61
|
+
```python
|
|
62
|
+
# 启用记忆模块
|
|
63
|
+
agent.enable_memory()
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
### 2. 工具集成
|
|
67
|
+
支持自定义工具(`Tools`),并通过 `register_tool` 方法注册工具。工具可以是任意 Python 函数,支持参数类型注解和自动生成工具描述。
|
|
68
|
+
|
|
69
|
+
```python
|
|
70
|
+
# 定义工具
|
|
71
|
+
def get_weather(city: str) -> str:
|
|
72
|
+
"""
|
|
73
|
+
获取城市天气信息
|
|
74
|
+
:param city: 城市名称
|
|
75
|
+
:return: 天气信息
|
|
76
|
+
"""
|
|
77
|
+
return f"城市 {city} 的天气信息"
|
|
78
|
+
|
|
79
|
+
# 注册工具
|
|
80
|
+
agent.register_tool(get_weather)
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
### 3. 思维树(ToT)
|
|
84
|
+
内置思维树模块,支持复杂任务分解和多步推理。通过思维树,Agent 可以更好地处理复杂任务。
|
|
85
|
+
|
|
86
|
+
```python
|
|
87
|
+
# 启用思维树
|
|
88
|
+
agent.enable_tot()
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
### 4. 多智能体协同
|
|
92
|
+
支持类 Swarm 的多智能体协同工作,提升任务处理效率。多个 Agent 可以协同完成复杂任务。
|
|
93
|
+
|
|
94
|
+
```python
|
|
95
|
+
# 创建多个 Agent
|
|
96
|
+
agent1 = LightAgent(model="chatglm")
|
|
97
|
+
agent2 = LightAgent(model="openai")
|
|
98
|
+
|
|
99
|
+
# 协同工作
|
|
100
|
+
response = agent1.collaborate(agent2, "请分析最近的市场趋势")
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
### 5. 多模型支持
|
|
104
|
+
兼容多种大模型,包括 OpenAI、智谱 ChatGLM、百川大模型、DeepSeek、Qwen 系列大模型。
|
|
105
|
+
|
|
106
|
+
```python
|
|
107
|
+
# 使用智谱 ChatGLM 模型
|
|
108
|
+
agent = LightAgent(model="chatglm")
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
### 6. 流式 API
|
|
112
|
+
支持 OpenAI 流格式 API 服务输出,无缝接入主流 Chat 框架。
|
|
113
|
+
|
|
114
|
+
```python
|
|
115
|
+
# 启用流式输出
|
|
116
|
+
response = agent.run("请生成一篇关于 AI 的文章", stream=True)
|
|
117
|
+
for chunk in response:
|
|
118
|
+
print(chunk)
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
### 7. Agent 测评
|
|
122
|
+
内置 Agent 测评工具,方便评估和优化 Agent 性能。
|
|
123
|
+
|
|
124
|
+
```python
|
|
125
|
+
# 运行测评
|
|
126
|
+
evaluation_result = agent.evaluate("请回答以下问题:什么是大模型?")
|
|
127
|
+
print(evaluation_result)
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
---
|
|
131
|
+
|
|
132
|
+
## 使用场景
|
|
133
|
+
|
|
134
|
+
- **智能客服**:通过多轮对话和工具集成,提供高效的客户支持。
|
|
135
|
+
- **数据分析**:利用思维树和多智能体协同,处理复杂的数据分析任务。
|
|
136
|
+
- **自动化工具**:通过自动化工具生成,快速构建定制化工具。
|
|
137
|
+
- **教育辅助**:通过记忆模块和流式 API,提供个性化的学习体验。
|
|
138
|
+
|
|
139
|
+
---
|
|
140
|
+
|
|
141
|
+
## 贡献指南
|
|
142
|
+
|
|
143
|
+
我们欢迎任何形式的贡献!如果您有好的想法或发现 Bug,请提交 Issue 或 Pull Request。
|
|
144
|
+
|
|
145
|
+
1. Fork 本项目。
|
|
146
|
+
2. 创建您的分支:`git checkout -b feature/YourFeature`。
|
|
147
|
+
3. 提交您的更改:`git commit -m 'Add some feature'`。
|
|
148
|
+
4. 推送分支:`git push origin feature/YourFeature`。
|
|
149
|
+
5. 提交 Pull Request。
|
|
150
|
+
|
|
151
|
+
---
|
|
152
|
+
|
|
153
|
+
## 许可证
|
|
154
|
+
|
|
155
|
+
LightAgent 采用 [Apache 许可证](LICENSE)。
|
|
156
|
+
|
|
157
|
+
---
|
|
158
|
+
|
|
159
|
+
## 联系我们
|
|
160
|
+
|
|
161
|
+
如有任何问题或建议,请联系我们:
|
|
162
|
+
|
|
163
|
+
- 邮箱:156713035@qq.com
|
|
164
|
+
- GitHub Issues: [https://github.com/wxai-space/lightagent/issues](https://github.com/wxai-space/lightagent/issues)
|
|
165
|
+
|
|
166
|
+
---
|
|
167
|
+
|
|
168
|
+
**LightAgent** —— 轻量、灵活、强大的主动式 Agent 框架,助您快速构建智能应用!
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
[tool.poetry]
|
|
2
|
+
name = "LightAgent"
|
|
3
|
+
version = "0.1.0"
|
|
4
|
+
description = "LightAgent a agent framework"
|
|
5
|
+
authors = ["caiweige"]
|
|
6
|
+
license = "Apache"
|
|
7
|
+
readme = "README.md"
|
|
8
|
+
repository = "https://github.com/wxai-space/LightAgent.git"
|
|
9
|
+
package-mode = false
|
|
10
|
+
|
|
11
|
+
[tool.poetry.dependencies]
|
|
12
|
+
python = ">=3.8.1,<3.12,!=3.9.7"
|
|
13
|
+
|
|
14
|
+
|
|
15
|
+
[tool.ruff]
|
|
16
|
+
extend-include = ["*.ipynb"]
|
|
17
|
+
extend-exclude = [
|
|
18
|
+
"docs/docs/expression_language/why.ipynb" # TODO: look into why linter errors
|
|
19
|
+
]
|
|
20
|
+
|
|
21
|
+
[tool.ruff.lint.per-file-ignores]
|
|
22
|
+
"**/{cookbook,docs}/*" = [
|
|
23
|
+
"E402", # allow imports to appear anywhere in docs
|
|
24
|
+
"F401", # allow "imported but unused" example code
|
|
25
|
+
"F811", # allow re-importing the same module, so that cells can stay independent
|
|
26
|
+
"F841", # allow assignments to variables that are never read -- it's example code
|
|
27
|
+
]
|
|
28
|
+
|
|
29
|
+
# These files were failing the listed rules at the time ruff was adopted for notebooks.
|
|
30
|
+
# Don't require them to change at once, though we should look into them eventually.
|
|
31
|
+
"cookbook/gymnasium_agent_simulation.ipynb" = ["F821"]
|
|
32
|
+
"docs/docs/integrations/document_loaders/tensorflow_datasets.ipynb" = ["F821"]
|
|
33
|
+
|
|
34
|
+
[tool.poetry.plugins.dotenv]
|
|
35
|
+
ignore = "false"
|
|
36
|
+
dotenv = "dotenv:plugin"
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
# https://python-poetry.org/docs/repositories/
|
|
40
|
+
[[tool.poetry.source]]
|
|
41
|
+
name = "tsinghua"
|
|
42
|
+
url = "https://pypi.tuna.tsinghua.edu.cn/simple/"
|
|
43
|
+
priority = "primary"
|
|
44
|
+
|
|
45
|
+
[build-system]
|
|
46
|
+
requires = ["setuptools>=42"]
|
|
47
|
+
build-backend = "setuptools.build_meta"
|
|
48
|
+
|
|
49
|
+
[project]
|
|
50
|
+
name = "LightAgent"
|
|
51
|
+
version = "0.1.0"
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
|
|
@@ -0,0 +1,225 @@
|
|
|
1
|
+
import json
|
|
2
|
+
import time
|
|
3
|
+
|
|
4
|
+
from loguru import logger
|
|
5
|
+
import inspect
|
|
6
|
+
import traceback
|
|
7
|
+
import requests
|
|
8
|
+
from typing import Callable, Any, Dict
|
|
9
|
+
import json
|
|
10
|
+
from datetime import datetime
|
|
11
|
+
from openai import OpenAI
|
|
12
|
+
from colorama import init, Fore
|
|
13
|
+
|
|
14
|
+
# Global registry for tools
|
|
15
|
+
from typing import List, Dict, Any, Callable
|
|
16
|
+
from copy import deepcopy
|
|
17
|
+
|
|
18
|
+
# 全局工具注册表
|
|
19
|
+
_FUNCTION_MAPPINGS = {} # 工具名称 -> 工具函数
|
|
20
|
+
_OPENAI_FUNCTION_SCHEMAS = [] # OpenAI 格式的工具描述
|
|
21
|
+
|
|
22
|
+
def register_tool_manually(tools: List[Callable]) -> None:
|
|
23
|
+
"""
|
|
24
|
+
手动注册多个工具,从函数属性中提取工具信息
|
|
25
|
+
:param tools: 工具函数列表
|
|
26
|
+
"""
|
|
27
|
+
for func in tools:
|
|
28
|
+
if not hasattr(func, "tool_info"):
|
|
29
|
+
raise ValueError(f"Function `{func.__name__}` does not have tool_info attribute.")
|
|
30
|
+
|
|
31
|
+
tool_info = func.tool_info
|
|
32
|
+
tool_name = tool_info["tool_name"]
|
|
33
|
+
_FUNCTION_MAPPINGS[tool_name] = func # 注册工具
|
|
34
|
+
|
|
35
|
+
# 构建 OpenAI 格式的工具描述
|
|
36
|
+
tool_params_openai = {}
|
|
37
|
+
tool_required = []
|
|
38
|
+
for param in tool_info["tool_params"]:
|
|
39
|
+
tool_params_openai[param["name"]] = {
|
|
40
|
+
"type": param["type"],
|
|
41
|
+
"description": param["description"],
|
|
42
|
+
}
|
|
43
|
+
if param["required"]:
|
|
44
|
+
tool_required.append(param["name"])
|
|
45
|
+
|
|
46
|
+
tool_def_openai = {
|
|
47
|
+
"type": "function",
|
|
48
|
+
"function": {
|
|
49
|
+
"name": tool_name,
|
|
50
|
+
"description": tool_info["tool_description"],
|
|
51
|
+
"parameters": {
|
|
52
|
+
"type": "object",
|
|
53
|
+
"properties": tool_params_openai,
|
|
54
|
+
"required": tool_required,
|
|
55
|
+
},
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
_OPENAI_FUNCTION_SCHEMAS.append(tool_def_openai)
|
|
60
|
+
|
|
61
|
+
def dispatch_tool(tool_name: str, tool_params: Dict[str, Any]) -> str:
|
|
62
|
+
"""
|
|
63
|
+
调用工具
|
|
64
|
+
"""
|
|
65
|
+
if tool_name not in _FUNCTION_MAPPINGS:
|
|
66
|
+
return f"Tool `{tool_name}` not found."
|
|
67
|
+
|
|
68
|
+
tool_call = _FUNCTION_MAPPINGS[tool_name]
|
|
69
|
+
try:
|
|
70
|
+
print(f"Calling tool: {tool_name} with params: {tool_params}") # 调试信息
|
|
71
|
+
return str(tool_call(**tool_params))
|
|
72
|
+
except Exception as e:
|
|
73
|
+
print(f"Tool call failed: {e}") # 调试信息
|
|
74
|
+
return traceback.format_exc()
|
|
75
|
+
|
|
76
|
+
def get_tools() -> List[Dict[str, Any]]:
|
|
77
|
+
"""
|
|
78
|
+
获取所有工具的描述(OpenAI 格式)
|
|
79
|
+
"""
|
|
80
|
+
return deepcopy(_OPENAI_FUNCTION_SCHEMAS)
|
|
81
|
+
|
|
82
|
+
class MultiAgentSystem:
|
|
83
|
+
def __init__(self, name: str, description: str):
|
|
84
|
+
self.name = name
|
|
85
|
+
self.description = description
|
|
86
|
+
|
|
87
|
+
def __call__(self, *args, **kwargs):
|
|
88
|
+
raise NotImplementedError("MultiAgentSystem must implement the __call__ method.")
|
|
89
|
+
|
|
90
|
+
|
|
91
|
+
class Tool:
|
|
92
|
+
def __init__(self, name: str, description: str):
|
|
93
|
+
self.name = name
|
|
94
|
+
self.description = description
|
|
95
|
+
|
|
96
|
+
def __call__(self, *args, **kwargs):
|
|
97
|
+
raise NotImplementedError("Tool must implement the __call__ method.")
|
|
98
|
+
|
|
99
|
+
class LightAgent:
|
|
100
|
+
def __init__(self, model: str, api_key: str, base_url: str , memory: bool = False, chain_of_thought: bool = False):
|
|
101
|
+
self.model = model
|
|
102
|
+
self.base_url = base_url
|
|
103
|
+
self.api_key = api_key
|
|
104
|
+
self.client = OpenAI(
|
|
105
|
+
base_url = self.base_url,
|
|
106
|
+
api_key = self.api_key
|
|
107
|
+
)
|
|
108
|
+
|
|
109
|
+
def run(self, query: str, stream=False, tools=[], max_retry=5):
|
|
110
|
+
# logger.info(f"\n开始思考问题: {query}")
|
|
111
|
+
now = datetime.now()
|
|
112
|
+
current_date = now.strftime("%Y-%m-%d")
|
|
113
|
+
current_time = now.strftime("%H:%M:%S")
|
|
114
|
+
SYSTEM_PROMPT = f"请记住你是万行一言AI金融搜索,请帮用户完成的金融数据查询和信息检索。请一步一步思考来完成用户的要求。尽可能拆解用户的输入先检索再回答。 /n 今日的日期: {current_date} 当前时间: {current_time}"
|
|
115
|
+
|
|
116
|
+
params = dict(model=self.model, messages=[{"role": "system", "content": SYSTEM_PROMPT},{"role": "user", "content": query}], stream=stream)
|
|
117
|
+
if tools:
|
|
118
|
+
register_tool_manually(tools)
|
|
119
|
+
print("Registered tools:", _FUNCTION_MAPPINGS.keys())
|
|
120
|
+
|
|
121
|
+
tools = get_tools()
|
|
122
|
+
params["tools"] = tools
|
|
123
|
+
response = self.client.chat.completions.create(**params)
|
|
124
|
+
# print(response)
|
|
125
|
+
|
|
126
|
+
for _ in range(max_retry):
|
|
127
|
+
if not stream:
|
|
128
|
+
if response.choices[0].message.tool_calls:
|
|
129
|
+
function_call = response.choices[0].message.tool_calls[0].function
|
|
130
|
+
# print(function_call,type)
|
|
131
|
+
print(f"Function Call Response: {function_call.model_dump()}")
|
|
132
|
+
|
|
133
|
+
function_args = json.loads(function_call.arguments)
|
|
134
|
+
tool_response = dispatch_tool(function_call.name, function_args)
|
|
135
|
+
logger.info(f"Tool Call Response: {tool_response}")
|
|
136
|
+
|
|
137
|
+
# params["messages"].append(response.choices[0].message)
|
|
138
|
+
params["messages"].append(
|
|
139
|
+
{
|
|
140
|
+
"role": "assistant",
|
|
141
|
+
"content": json.dumps(function_call.model_dump()), # 调用ai接口返回的文本
|
|
142
|
+
}
|
|
143
|
+
)
|
|
144
|
+
params["messages"].append(
|
|
145
|
+
{
|
|
146
|
+
"role": "user",
|
|
147
|
+
"name": function_call.name,
|
|
148
|
+
"content": tool_response, # 调用函数返回结果
|
|
149
|
+
}
|
|
150
|
+
)
|
|
151
|
+
else:
|
|
152
|
+
reply = response.choices[0].message.content
|
|
153
|
+
# logger.info(f"Final Reply: \n{reply}")
|
|
154
|
+
return reply
|
|
155
|
+
|
|
156
|
+
else:
|
|
157
|
+
output = ""
|
|
158
|
+
function_call = []
|
|
159
|
+
function_call_name = ""
|
|
160
|
+
function_call_arguments = ""
|
|
161
|
+
for chunk in response:
|
|
162
|
+
|
|
163
|
+
content = chunk.choices[0].delta.content or ""
|
|
164
|
+
print(Fore.BLUE + content, end="", flush=True)
|
|
165
|
+
output += content
|
|
166
|
+
|
|
167
|
+
try:
|
|
168
|
+
if chunk.choices and chunk.choices[0].delta.tool_calls:
|
|
169
|
+
argumentsTxt = chunk.choices[0].delta.tool_calls[0].function.arguments
|
|
170
|
+
# 检查 argumentsTxt 是否为空
|
|
171
|
+
if argumentsTxt:
|
|
172
|
+
function_call_arguments += argumentsTxt
|
|
173
|
+
except (IndexError, AttributeError, KeyError):
|
|
174
|
+
pass
|
|
175
|
+
|
|
176
|
+
try:
|
|
177
|
+
if function_call_name == '' and chunk.choices[0].delta.tool_calls:
|
|
178
|
+
function_call_name=chunk.choices[0].delta.tool_calls[0].function.name
|
|
179
|
+
except (IndexError, AttributeError, KeyError):
|
|
180
|
+
pass
|
|
181
|
+
|
|
182
|
+
if chunk.choices[0].finish_reason == "stop":
|
|
183
|
+
return output
|
|
184
|
+
|
|
185
|
+
elif chunk.choices[0].finish_reason == "tool_calls":
|
|
186
|
+
function_call={
|
|
187
|
+
"name":function_call_name,
|
|
188
|
+
"arguments":function_call_arguments,
|
|
189
|
+
}
|
|
190
|
+
# function_call = json.dumps(function_call_dist,ensure_ascii=False)
|
|
191
|
+
# print(function_call)
|
|
192
|
+
|
|
193
|
+
logger.info(f"正在调用工具: {function_call}")
|
|
194
|
+
|
|
195
|
+
function_args = json.loads(function_call["arguments"])
|
|
196
|
+
tool_response = dispatch_tool(function_call["name"], function_args)
|
|
197
|
+
# logger.info(f"工具响应: {tool_response}")
|
|
198
|
+
|
|
199
|
+
params["messages"].append(
|
|
200
|
+
{
|
|
201
|
+
"role": "assistant",
|
|
202
|
+
"content": output, # 调用ai接口返回的文本
|
|
203
|
+
}
|
|
204
|
+
)
|
|
205
|
+
params["messages"].append(
|
|
206
|
+
{
|
|
207
|
+
"role": "function",
|
|
208
|
+
"name": function_call["name"],
|
|
209
|
+
"content": tool_response,
|
|
210
|
+
}
|
|
211
|
+
)
|
|
212
|
+
|
|
213
|
+
break
|
|
214
|
+
|
|
215
|
+
# print(params)
|
|
216
|
+
response = self.client.chat.completions.create(**params)
|
|
217
|
+
# return response
|
|
218
|
+
|
|
219
|
+
return "Failed to generate a valid response."
|
|
220
|
+
|
|
221
|
+
|
|
222
|
+
if __name__ == "__main__":
|
|
223
|
+
# Example of registering and using a tool
|
|
224
|
+
print("This is LightAgent")
|
|
225
|
+
# print(dispatch_tool("example_tool", {"param1": "test"}))
|