@agentunion/kite 1.4.0 → 1.5.0

package/extensions/services/proxy/agentcp/samples/deepseek/README.md

@@ -0,0 +1,79 @@
+# github
+[https://github.com/auliwenjiang/agentcp/blob/master/samples/deepseek](https://github.com/auliwenjiang/agentcp/blob/master/samples/deepseek)
+
+# README.md
+
+## 1、使用指南
+### 1)、创建agent身份
+请参考[一、创建身份，读写公有私有数据](https://ccnz88r91l2y.feishu.cn/wiki/I5F4whGuFioqwNkfJ45c8ZQ3nGf)
+- 运行create_profile.py,创建agent
+
+### 2)、添加并配置.env文件
+``` bash
+BASE_URL=https://api.siliconflow.cn/v1 # 改成实际url
+OPENAI_API_KEY=sk-*********** # 改成实际api key
+MODEL_NAME=deepseek-ai/DeepSeek-R1-Distill-Qwen-7B  # 改成实际大模型
+AID=deepseekdemo.agentunion.cn # 改成自己实际注册aid
+```
+### 3）、添加依赖
+``` bash
+pip install openai==1.77.0 -i https://pypi.tuna.tsinghua.edu.cn/simple/
+```
+### 4)、目录结构
+```bash
+.
+├── create_profile.py  # agent注册脚本
+├── .env   # 环境变量配置
+├── deeepseek.py  # 智能体实现
+```
+### 5)、执行代码
+```bash
+python deepseek.py
+```
+
+## 2、功能简介
+基于AgentCP SDK开发的deepseek大模型智能体，实现大模型能力与智能体网络的无缝对接。使网络中的其他智能体可以通过调用该智能体的API来获取大模型的响应。
+
+## 3、环境要求
+- Python 3.8+
+- AgentCP SDK
+- OpenAI兼容API服务
+
+## 4、核心类说明
+### 1）、agent上线
+```python
+acp = agentcp.AgentCP(os.path.pardir, debug=True)
+print(f"当前acp访问路径:{acp.app_path}\n开始:agentcp版本:{agentcp.__version__},{__file__}")
+aid = acp.load_aid(os.getenv('AID'))
+
+# agent上线
+aid.online()
+
+# 开启永久监听
+acp.serve_forever()
+```
+### 2）、消息处理
+```python
+@aid.message_handler()
+async def sync_message_handler(msg):
+    # 大模型对话
+    response = llm_chat(query=aid.get_content_from_message(msg))
+    # 消息回复
+    aid.send_message_content(aid.get_session_id_from_message(msg), [aid.get_sender_from_message(msg)], response)
+    return True
+```
+### 3）、大模型调用
+```python
+def llm_chat(query: str) -> str:
+    """ 基于openai的大模型调用 """
+    client = OpenAI(api_key=openai_api_key, base_url=base_url)
+    response = client.chat.completions.create(model=model_name, messages=[{'role': 'user', 'content': query}])
+    result = response.choices[0].message.content
+    print(f'大模型[{model_name}]回复[query = {query}]：response = {result}')
+    return result
+```
+
+## 注意事项
+1. 大模型环境变量正确配置
+2. 智能体网络接入需要有效的seed_password
+3. 生产环境建议关闭debug模式

package/extensions/services/proxy/agentcp/samples/deepseek/create_profile.py

@@ -0,0 +1,126 @@
+from datetime import datetime, timezone
+import agentcp
+import os
+from pathlib import Path  # 新增导入
+import json
+def create_financial_analyzer_json(publisherInfo):
+    """创建智能体能力、权限描述"""
+    profile_json_data = {
+        "publisherInfo": publisherInfo,
+        "avaUrl": "https://resouces.modelscope.cn/avatar/6c8d6d52-b760-4538-9b32-35dd5ebecc68.jpg",
+        "version": "1.0.0",
+        "lastUpdated": datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ"),
+        "name": "deepseek",
+        "description": "deepseek大模型对话:输入字符串,输出字符串",
+        "capabilities": {
+            "core": ["大模型智能体"],
+            "extended": []
+        },
+        "llm":{
+            "model":"qwen-plus", #模型名称，或使用aid
+            "num_parameters":"",  #模型参数量（如"7B"表示70亿参数）
+            "quantization_bits":"",  #量化位数（如Q4表示4位量化）
+            "context_length":"",  #上下文长度（如"4096"表示4096个token）
+        },
+        "references": {
+            "knowledgeBases": [""],
+            "tools": [""],
+            "companyInfo": [""],
+            "productInfo": [""]
+        },
+        "authorization": {
+            "modes": ["free"],
+            "fee": {},
+            "description": "当前智能体免费使用，无费用",
+            "sla": {}
+        },
+        "input": {
+            "types": ["content"], # 目前支持"content", "search", "reasoning_content", "error", 'file',后续会支持语音视频流
+            "formats": ["json"], #  详细类型
+            "examples": {
+                "type": "content",
+                "format": "text",
+                "content": "搜索智能体：xxx"
+            },
+            "semantics": [""],
+            "compatibleAids": ["*"]
+        },
+        "output": {
+            "types": ["content"],
+            "formats": ["markdown"],
+            "examples": {
+                "type": "content",
+                "format": "markdown",
+                "content": ""
+            },
+            "semantics": [""],
+            "compatibleAids": [""]
+        },
+        "supportStream": False, # False代表当前智能体不支持流式输出
+        "supportAsync": True,
+        "permission": ["*"]
+    }
+    return profile_json_data
+
+def write_agent_profile_json(json_data):
+    try:
+        import os
+        json_path = Path(__file__).resolve()
+        json_dir = json_path.parent
+        json_file = os.path.join(json_dir, 'agentprofile.json')
+        with open(json_file, 'w', encoding='utf-8') as f:
+            json.dump(json_data, f, ensure_ascii=False, indent=2)
+            print("智能体描述文件已保存至当前目录下agentprofile.json")
+    except Exception as e:
+        print(f"文件写入失败: {str(e)}")
+        exit(1)
+
+
+if __name__ == "__main__":
+    # 创建JSON数据
+    # 将加密种子修改为自己的加密种子，可以是随机字符串，也可以是固定字符串，只要保证一致即可。
+    acp = agentcp.AgentCP(os.path.pardir ,seed_password="123456",debug=False)
+    agentid_list = acp.get_aid_list()
+    agentid:agentcp.AgentID = None
+    while agentid is None:
+        print("请选择一个身份（aid）:")
+        for i, agentid in enumerate(agentid_list):
+            print(f"{i+1}. {agentid}")
+        print(f"{len(agentid_list)+1}. 创建一个新的身份（aid）")
+        choice = input("请输入数字选择一个身份（aid）: ")
+        try:
+            choice = int(choice) - 1
+            if choice < 0 or choice > len(agentid_list):
+                raise ValueError
+            if choice == len(agentid_list):
+                aid = input("请输入名称: ")
+                agentid = acp.create_aid("agentunion.cn",aid)
+                if agentid is None:
+                    print("创建身份（aid）失败，请打开日志查看原因")
+                    exit(1)
+                agentid_list = acp.get_aid_list()
+            else:
+                agentid = acp.load_aid(agentid_list[choice])    
+                if agentid is None:
+                    print("加载身份（aid）失败,请打开日志查看原因")
+                    exit(1)
+        except ValueError:
+            print("无效的选择，请重新输入。")
+    print(f"当前选择的身份（aid）是: {str(agentid)}")
+    agentid.init_ap_client()
+    json_data = create_financial_analyzer_json(agentid.get_publisher_info())
+    write_agent_profile_json(json_data)
+    select_result = input("是否将文件拷贝到agent公有数据目录下（Y/N）: ")
+    if select_result.upper() != "Y":
+        print("程序运行结束")
+        exit(1)
+    agentid.create_agent_profile(json_data)
+    select_result = input("拷贝成功，是否同步到接入服务器（Y/N）: ")
+    if select_result.upper() != "Y":
+        print("程序运行结束")
+        exit(1)
+    result = agentid.sync_public_files()
+    if result:
+        print("文件同步成功！")
+    else:
+        print("文件同步失败,请初始化ACP时打开日志查看")

package/extensions/services/proxy/agentcp/samples/deepseek/deepseek.py

@@ -0,0 +1,42 @@
+# -*- coding:utf-8 -*-
+"""
+deepseek大模型对话:输入字符串,输出字符串
+https://resouces.modelscope.cn/avatar/6c8d6d52-b760-4538-9b32-35dd5ebecc68.jpg
+"""
+import agentcp
+import os
+from openai import OpenAI
+from dotenv import load_dotenv, find_dotenv
+
+# 加载并读取环境变量
+load_dotenv(find_dotenv())
+base_url = os.getenv('BASE_URL')
+openai_api_key = os.getenv('OPENAI_API_KEY')
+model_name = os.getenv('MODEL_NAME')
+
+def llm_chat(query: str) -> str:
+    """ 基于openai的大模型调用 """
+    client = OpenAI(api_key=openai_api_key, base_url=base_url)
+    response = client.chat.completions.create(model=model_name, messages=[{'role': 'user', 'content': query}])
+    result = response.choices[0].message.content
+    print(f'大模型[{model_name}]回复[query = {query}]：response = {result}')
+    return result
+
+if __name__ == "__main__":
+    acp = agentcp.AgentCP(os.path.pardir, seed_password='123456', debug=True)
+    print(f"当前acp访问路径:{acp.app_path}\n开始:agentcp版本:{agentcp.__version__},{__file__}")
+    aid = acp.load_aid(os.getenv('AID'))
+
+    @aid.message_handler()
+    async def sync_message_handler(msg):
+        # 大模型对话
+        response = llm_chat(query=aid.get_content_from_message(msg))
+        # 消息回复
+        aid.send_message_content(aid.get_session_id_from_message(msg), [aid.get_sender_from_message(msg)], response)
+        return True
+
+    # agent上线
+    aid.online()
+
+    # 开启永久监听
+    acp.serve_forever()

package/extensions/services/proxy/agentcp/samples/dify_chat/README.md

@@ -0,0 +1,78 @@
+# github
+[https://github.com/auliwenjiang/agentcp/blob/master/samples/dify_chat](https://github.com/auliwenjiang/agentcp/blob/master/samples/dify_chat)
+
+# README.md
+
+## 1、使用指南
+### 1)、创建agent身份
+请参考[一、创建身份，读写公有私有数据](https://ccnz88r91l2y.feishu.cn/wiki/I5F4whGuFioqwNkfJ45c8ZQ3nGf)
+- 运行create_profile.py,创建agent
+
+### 2)、添加并配置.env文件
+``` bash
+BASE_URL=http://your_host/v1/chat-messages # 改成实际url
+API_KEY=app-1qMAqDifpRiOsnNR7mYOM3uv # 改成实际api key
+AID=difychatdemo.agentunion.cn # 改成自己实际注册aid
+```
+
+### 3)、目录结构
+```bash
+.
+├── create_profile.py  # agent注册脚本
+├── .env   # 环境变量配置
+├── dify_chat.py  # 智能体实现
+```
+### 4)、执行代码
+```bash
+python dify_chat.py
+```
+
+## 2、功能简介
+基于AgentCP SDK开发的dify chat智能体，实现dify chat能力与智能体网络的无缝对接。使网络中的其他智能体可以通过调用该智能体的API来获取dify chat的响应。
+
+## 3、环境要求
+- Python 3.8+
+- AgentCP SDK
+
+## 4、核心类说明
+### 1）、agent上线
+```python
+acp = agentcp.AgentCP(os.path.pardir, debug=True)
+print(f"当前acp访问路径:{acp.app_path}\n开始:agentcp版本:{agentcp.__version__},{__file__}")
+aid = acp.load_aid(os.getenv('AID'))
+
+# agent上线
+aid.online()
+
+# 开启永久监听
+acp.serve_forever()
+```
+### 2）、消息处理
+```python
+@aid.message_handler()
+async def sync_message_handler(msg):
+    # 大模型对话
+    response = dify_chat_client(query=aid.get_content_from_message(msg))
+    # 消息回复
+    aid.send_message_content(aid.get_session_id_from_message(msg), [aid.get_sender_from_message(msg)], response)
+    return True
+```
+### 3）、dify调用
+```python
+def dify_chat_client(query: str)-> str:
+    """ dify chat 客户端"""
+    headers = { 'Authorization': f'Bearer {api_key}', 'Content-Type': 'application/json; charset=utf-8'}
+    data = json.dumps({'inputs': {} ,'query': query, 'conversation_id': '', 'user': os.getenv('AID')}, ensure_ascii=False).encode('utf-8')
+    response = requests.post(base_url, headers=headers, data=data, stream=False)
+    print(f'dify response = {response}')
+    if response.status_code != 200:
+        return f'请求失败：{response.text}'
+    result = json.loads(response.text)['answer']
+    print(f'difychat回复[query = {query}]：response = {result}')
+    return result
+```
+
+## 注意事项
+1. dify环境变量正确配置
+2. 智能体网络接入需要有效的seed_password
+3. 生产环境建议关闭debug模式

package/extensions/services/proxy/agentcp/samples/dify_chat/create_profile.py

@@ -0,0 +1,126 @@
+from datetime import datetime, timezone
+import agentcp
+import os
+from pathlib import Path  # 新增导入
+import json
+def create_financial_analyzer_json(publisherInfo):
+    """创建智能体能力、权限描述"""
+    profile_json_data = {
+        "publisherInfo": publisherInfo,
+        "avaUrl": "https://tse3-mm.cn.bing.net/th/id/OIP-C.Hux_MNYiHtMI5EnBzSIubAAAAA?rs=1&pid=ImgDetMain",
+        "version": "1.0.0",
+        "lastUpdated": datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ"),
+        "name": "deepseek",
+        "description": "SSE模式接入dify的chat:输入字符串,输出字符串",
+        "capabilities": {
+            "core": ["dify chat 智能体"],
+            "extended": []
+        },
+        "llm":{
+            "model":"qwen-plus", #模型名称，或使用aid
+            "num_parameters":"",  #模型参数量（如"7B"表示70亿参数）
+            "quantization_bits":"",  #量化位数（如Q4表示4位量化）
+            "context_length":"",  #上下文长度（如"4096"表示4096个token）
+        },
+        "references": {
+            "knowledgeBases": [""],
+            "tools": [""],
+            "companyInfo": [""],
+            "productInfo": [""]
+        },
+        "authorization": {
+            "modes": ["free"],
+            "fee": {},
+            "description": "当前智能体免费使用，无费用",
+            "sla": {}
+        },
+        "input": {
+            "types": ["content"], # 目前支持"content", "search", "reasoning_content", "error", 'file',后续会支持语音视频流
+            "formats": ["json"], #  详细类型
+            "examples": {
+                "type": "content",
+                "format": "text",
+                "content": "搜索智能体：xxx"
+            },
+            "semantics": [""],
+            "compatibleAids": ["*"]
+        },
+        "output": {
+            "types": ["content"],
+            "formats": ["markdown"],
+            "examples": {
+                "type": "content",
+                "format": "markdown",
+                "content": ""
+            },
+            "semantics": [""],
+            "compatibleAids": [""]
+        },
+        "supportStream": False, # False代表当前智能体不支持流式输出
+        "supportAsync": True,
+        "permission": ["*"]
+    }
+    return profile_json_data
+
+def write_agent_profile_json(json_data):
+    try:
+        import os
+        json_path = Path(__file__).resolve()
+        json_dir = json_path.parent
+        json_file = os.path.join(json_dir, 'agentprofile.json')
+        with open(json_file, 'w', encoding='utf-8') as f:
+            json.dump(json_data, f, ensure_ascii=False, indent=2)
+            print("智能体描述文件已保存至当前目录下agentprofile.json")
+    except Exception as e:
+        print(f"文件写入失败: {str(e)}")
+        exit(1)
+
+
+if __name__ == "__main__":
+    # 创建JSON数据
+    # 将加密种子修改为自己的加密种子，可以是随机字符串，也可以是固定字符串，只要保证一致即可。
+    acp = agentcp.AgentCP(os.path.pardir ,seed_password="123456",debug=False)
+    agentid_list = acp.get_aid_list()
+    agentid:agentcp.AgentID = None
+    while agentid is None:
+        print("请选择一个身份（aid）:")
+        for i, agentid in enumerate(agentid_list):
+            print(f"{i+1}. {agentid}")
+        print(f"{len(agentid_list)+1}. 创建一个新的身份（aid）")
+        choice = input("请输入数字选择一个身份（aid）: ")
+        try:
+            choice = int(choice) - 1
+            if choice < 0 or choice > len(agentid_list):
+                raise ValueError
+            if choice == len(agentid_list):
+                aid = input("请输入名称: ")
+                agentid = acp.create_aid("agentunion.cn",aid)
+                if agentid is None:
+                    print("创建身份（aid）失败，请打开日志查看原因")
+                    exit(1)
+                agentid_list = acp.get_aid_list()
+            else:
+                agentid = acp.load_aid(agentid_list[choice])    
+                if agentid is None:
+                    print("加载身份（aid）失败,请打开日志查看原因")
+                    exit(1)
+        except ValueError:
+            print("无效的选择，请重新输入。")
+    print(f"当前选择的身份（aid）是: {str(agentid)}")
+    agentid.init_ap_client()
+    json_data = create_financial_analyzer_json(agentid.get_publisher_info())
+    write_agent_profile_json(json_data)
+    select_result = input("是否将文件拷贝到agent公有数据目录下（Y/N）: ")
+    if select_result.upper() != "Y":
+        print("程序运行结束")
+        exit(1)
+    agentid.create_agent_profile(json_data)
+    select_result = input("拷贝成功，是否同步到接入服务器（Y/N）: ")
+    if select_result.upper() != "Y":
+        print("程序运行结束")
+        exit(1)
+    result = agentid.sync_public_files()
+    if result:
+        print("文件同步成功！")
+    else:
+        print("文件同步失败,请初始化ACP时打开日志查看")

package/extensions/services/proxy/agentcp/samples/dify_chat/dify_chat.py

@@ -0,0 +1,47 @@
+# -*- coding:utf-8 -*-
+"""
+基础配置:
+SSE模式接入dify的chat:输入字符串,输出字符串
+https://tse3-mm.cn.bing.net/th/id/OIP-C.Hux_MNYiHtMI5EnBzSIubAAAAA?rs=1&pid=ImgDetMain
+"""
+import agentcp
+import os
+import json
+import requests
+from dotenv import load_dotenv, find_dotenv
+
+# 加载并读取环境变量
+load_dotenv(find_dotenv())
+base_url = os.getenv('BASE_URL')
+api_key = os.getenv('API_KEY')
+
+
+def dify_chat_client(query: str)-> str:
+    """ dify chat 客户端"""
+    headers = { 'Authorization': f'Bearer {api_key}', 'Content-Type': 'application/json; charset=utf-8'}
+    data = json.dumps({'inputs': {} ,'query': query, 'conversation_id': '', 'user': os.getenv('AID')}, ensure_ascii=False).encode('utf-8')
+    response = requests.post(base_url, headers=headers, data=data, stream=False)
+    print(f'dify response = {response}')
+    if response.status_code != 200:
+        return f'请求失败：{response.text}'
+    result = json.loads(response.text)['answer']
+    print(f'difychat回复[query = {query}]：response = {result}')
+    return result
+
+if __name__ == "__main__":
+    acp = agentcp.AgentCP(os.path.pardir, seed_password='123456', debug=True)
+    print(f"当前acp访问路径:{acp.app_path}\n开始:agentcp版本:{agentcp.__version__},{__file__}")
+    aid = acp.load_aid(os.getenv('AID'))
+
+    @aid.message_handler()
+    async def sync_message_handler(msg):
+        # 大模型对话
+        response = dify_chat_client(query=aid.get_content_from_message(msg))
+        # 消息回复
+        aid.send_message_content(aid.get_session_id_from_message(msg), [aid.get_sender_from_message(msg)], response)
+        return True
+
+    # agent上线
+    aid.online()
+    # 开启永久监听
+    acp.serve_forever()

package/extensions/services/proxy/agentcp/samples/dify_workflow/README.md

@@ -0,0 +1,78 @@
+# github
+[https://github.com/auliwenjiang/agentcp/blob/master/samples/dify_workflow](https://github.com/auliwenjiang/agentcp/blob/master/samples/dify_workflow)
+
+# README.md
+
+## 1、使用指南
+### 1)、创建agent身份
+请参考[一、创建身份，读写公有私有数据](https://ccnz88r91l2y.feishu.cn/wiki/I5F4whGuFioqwNkfJ45c8ZQ3nGf)
+- 运行create_profile.py,创建agent
+
+### 2)、添加并配置.env文件
+``` bash
+BASE_URL=http://your_host/v1/workflows/run # 改成实际url
+API_KEY=app-1qMAqDifpRiOsnNR7mYOM3uv # 改成实际api key
+AID=difyworkflowdemo.agentunion.cn # 改成自己实际注册aid
+```
+
+### 3)、目录结构
+```bash
+.
+├── create_profile.py  # agent注册脚本
+├── .env   # 环境变量配置
+├── dify_workflow.py  # 智能体实现
+```
+### 4)、执行代码
+```bash
+python dify_workflow.py
+```
+
+## 2、功能简介
+基于AgentCP SDK开发的dify workflow智能体，实现dify workflow能力与智能体网络的无缝对接。使网络中的其他智能体可以通过调用该智能体的API来获取dify workflow的响应。
+
+## 3、环境要求
+- Python 3.8+
+- AgentCP SDK
+
+## 4、核心类说明
+### 1）、agent上线
+```python
+acp = agentcp.AgentCP(os.path.pardir, debug=True)
+print(f"当前acp访问路径:{acp.app_path}\n开始:agentcp版本:{agentcp.__version__},{__file__}")
+aid = acp.load_aid(os.getenv('AID'))
+
+# agent上线
+aid.online()
+
+# 开启永久监听
+acp.serve_forever()
+```
+### 2）、消息处理
+```python
+@aid.message_handler()
+async def sync_message_handler(msg):
+    # 大模型对话
+    response = dify_workflow_client(query=aid.get_content_from_message(msg))
+    # 消息回复
+    aid.send_message_content(aid.get_session_id_from_message(msg), [aid.get_sender_from_message(msg)], response)
+    return True
+```
+### 3）、dify调用
+```python
+def dify_workflow_client(query: str)-> str:
+    """ dify工作流客户端"""
+    headers = { 'Authorization': f'Bearer {api_key}', 'Content-Type': 'application/json; charset=utf-8'}
+    data = json.dumps({'inputs': {'query':query}, 'conversation_id': '', 'user': os.getenv('AID')}, ensure_ascii=False).encode('utf-8')
+    response = requests.post(base_url, headers=headers, data=data, stream=False)
+    print(f'dify response = {response}')
+    if response.status_code != 200:
+        return f'请求失败：{response.text}'
+    result = json.loads(response.text)['data']['outputs']['text']
+    print(f'difyworkflow回复[query = {query}]：response = {result}')
+    return result
+```
+
+## 注意事项
+1. dify环境变量正确配置
+2. 智能体网络接入需要有效的seed_password
+3. 生产环境建议关闭debug模式