Feat: Add toolkit demo app

This commit is contained in:
AniviaTn
2025-04-28 15:37:54 +08:00
parent bebf614d8f
commit ca437d758d
104 changed files with 2024 additions and 5 deletions

View File

@@ -38,4 +38,8 @@ metadata:
- 在MCPTool中name除了表示agentUniverse中工具的名称也表示MCPServer中工具的名称。如果您希望使用一个不一样的名字您可以使用`origin_tool_name`参数指定MCPServer中的真实工具名称
- description和普通Tool不同,允许为空。如果不主动填写会使用MCPServer中对于该工具的描述作为默认description
- server_name用于标识一个唯一的MCPServer统一server_name的MCPServer在请求过程中共享session
- transport取值分为`stdio``sse`分别表示通过标准输入输出流和SSE连接MCPServer。当transport取值为`stdio`时,需要配置`command``args`参数用于通过命令启动一个本地的MCPServer。`env`为可选参数类型是dict表示运行时的环境变量。当transport取值为`sse`时,您需要配置`url`参数用于连接一个远程的MCPServer
- transport取值分为`stdio``sse`分别表示通过标准输入输出流和SSE连接MCPServer。当transport取值为`stdio`时,需要配置`command``args`参数用于通过命令启动一个本地的MCPServer。`env`为可选参数类型是dict表示运行时的环境变量。当transport取值为`sse`时,您需要配置`url`参数用于连接一个远程的MCPServer
工具定义示例可参考:[duckduckgo_search_mcp_tool](../../../../../../examples/sample_apps/toolkit_demo_app/intelligence/agentic/tool/duckduckgo_search_mcp_tool.yaml)
工具调用可参考示例:[demo_react_agent_with_single_mcp_tool](../../../../../../examples/sample_apps/toolkit_demo_app/intelligence/agentic/agent/agent_instance/react_agent_case/demo_react_agent_with_single_mcp_tool.yaml)

View File

@@ -87,7 +87,9 @@ tool = ['sample_standard_app.intelligence.agentic.tool']
## 在Agent中配置使用
您可以根据[智能体创建与使用](../智能体/智能体创建与使用.md)中的内容在agent的action下的tool中设置您创建的任意工具。
可参考示例:`demo_agent` 具体文件路径为 `agentUniverse/examples/sample_standard_app/intelligence/agentic/agent/agent_instance/demo_agent.yaml`
工具定义示例可参考:[duckduckgo_search_mcp_tool](../../../../../../examples/sample_apps/toolkit_demo_app/intelligence/agentic/tool/python_runner.yaml)
工具调用可参考示例:[demo_react_agent_with_single_mcp_tool](../../../../../../examples/sample_apps/toolkit_demo_app/intelligence/agentic/agent/agent_instance/react_agent_case/demo_react_agent_with_single_tool.yaml)
## 使用Tool管理器
通过Tool管理器中的`.get_instance_obj(xx_tool_name)` 方法可以获取对应名称的Tool实例, 使用`run`方法进行调用。

View File

@@ -35,5 +35,8 @@ metadata:
module: 'agentuniverse.agent.action.toolkit.mcp_toolkit'
class: 'MCPToolkit'
```
- 关于`transport``url``command``args``env`参数的填写方式请参考[MCP工具](../工具/MCP工具.md)
- 关于`transport``url``command``args``env`参数的填写方式请参考[MCP工具](../工具/MCP工具.md)
完整工具包定义示例可参考:[duckduckgo_search_mcp_tool](../../../../../../examples/sample_apps/toolkit_demo_app/intelligence/agentic/toolkit/docx_toolkit.yaml)
工具包调用可参考示例:[demo_react_agent_with_single_mcp_tool](../../../../../../examples/sample_apps/toolkit_demo_app/intelligence/agentic/agent/agent_instance/react_agent_case/demo_react_agent_with_mcp_toolkit.yaml)

View File

@@ -56,7 +56,9 @@ action:
toolkit:
- 'search_toolkit'
```
完整示例可参考:`demo_agent` 具体文件路径为 `agentUniverse/examples/sample_standard_app/intelligence/agentic/agent/agent_instance/demo_agent.yaml`
完整工具包定义示例可参考:[duckduckgo_search_mcp_tool](../../../../../../examples/sample_apps/toolkit_demo_app/intelligence/agentic/toolkit/simple_math_toolkit.yaml)
工具包调用可参考示例:[demo_react_agent_with_single_mcp_tool](../../../../../../examples/sample_apps/toolkit_demo_app/intelligence/agentic/agent/agent_instance/react_agent_case/demo_react_agent_with_toolkit.yaml)
通过这样的配置,智能体就能像使用普通工具一样使用工具包中的工具了。