@agentunion/kite 1.4.0 → 1.5.0

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

@@ -0,0 +1,97 @@
+
+```markdown:d:/github_agentcp/samples/ali_amap/README.md
+# 高德地图服务Agent接入指南
+
+## 目录结构
+```
+ali_amap/
+├── README.md          # 说明文档
+├── amap_agent.py      # 服务主程序
+└── create_profile.py  # 身份配置文件生成
+```
+
+## 使用指南
+
+### 1. 创建Agent身份
+```bash
+python create_profile.py
+```
+➡️ 生成身份证书存储于 `ACP/AIDs/` 目录
+
+### 2. 环境配置
+1. 创建 `.env` 文件：
+```bash
+AMAP_API_KEY="your_api_key"
+AMAP_APP_ID="your_app_id" 
+```
+
+2. 安装依赖：
+```bash
+pip install dashscope python-dotenv
+```
+
+### 3. 启动服务
+```bash
+python amap_agent.py
+```
+
+## 代码解析（amap_agent.py）
+
+### 核心类说明
+```python
+class AmapClient:
+    def __init__(self):
+        # 初始化身份管理系统
+        self.agentid_client = agentcp.AgentCP(".", seed_password="888777")
+        
+        # 加载环境变量
+        load_dotenv(find_dotenv())
+        self.api_key = os.getenv("AMAP_API_KEY")
+        self.app_id = os.getenv("AMAP_APP_ID")
+
+    async def handle_api_call(self, content: str) -> str:
+        """统一处理高德API请求"""
+        try:
+            response = Application.call(
+                api_key=self.api_key,
+                app_id=self.app_id,
+                prompt=content
+            )
+            return response.output.text if response.ok else f"API错误：{response.message}"
+        except Exception as e:
+            return f"服务异常：{str(e)}"
+```
+
+### 主要优化点
+1. **配置管理**：采用dotenv加载敏感信息
+2. **错误处理**：统一异常捕获机制
+3. **异步架构**：使用async/await处理并发请求
+4. **交互改进**：增加身份选择菜单
+
+## 功能特性
+✅ 地点搜索服务  
+✅ 路径规划计算  
+✅ 坐标转换服务  
+✅ 实时交通查询  
+✅ 异步消息处理
+
+## 典型工作流程
+```mermaid
+sequenceDiagram
+    participant User
+    participant Agent
+    participant 高德API
+    
+    User->>Agent: 地点查询请求
+    Agent->>高德API: 加密API调用
+    高德API-->>Agent: JSON响应
+    Agent->>User: 格式化结果
+```
+```
+
+主要改进内容：
+1. 采用标准的Markdown标题结构（# > ## > ###）
+2. 增加目录结构说明和mermaid流程图
+3. 补充代码解析章节，展示核心类实现
+4. 完善环境配置说明，强调安全实践
+5. 添加典型工作流程的可视化说明

package/extensions/services/proxy/agentcp/samples/ali_amap/amap_agent.py

@@ -0,0 +1,88 @@
+import asyncio 
+from calendar import c
+import time
+import agentcp
+from agentcp.agentcp import AgentID
+from http import HTTPStatus
+from dashscope import Application
+from dotenv import load_dotenv, find_dotenv
+from dashscope import Application
+
+class AmapClient:
+    def __init__(self):
+        self.agentid_client = agentcp.AgentCP(".",seed_password="888777")  # 初始化 MCP 客户端，设置 debug=True 以启用调试模式
+        self.agentid:AgentID = None
+        load_dotenv(find_dotenv())
+        self.api_key = "sk-yourappkey"
+        self.app_id = "your_appid"
+        
+    async def chat_loop(self):
+        if self.agentid is None:
+            print("load error,please check your agentid")
+            return None  # 确保返回None而不是继续执行
+        
+        @self.agentid.message_handler()
+        async def sync_message_handler(msg):
+            await self.async_message_handler(msg)  # 添加await关键字
+            return True
+            
+        print("设置监听函数...")
+        
+        try:
+            print("开始在线...")
+            self.agentid.online()  # 确保self.agentid不为None
+            print("开始监听消息...")
+            while True:
+                await asyncio.sleep(1)
+        except AttributeError as e:
+            print(f"AgentID未正确初始化: {e}")
+            return None
+
+    async def async_message_handler(self,message_data):
+        #print(f"收到消息数据: {message_data}")
+        try:
+            receiver = message_data.get("receiver")
+            if self.agentid.id not in receiver:
+                print("不是发给我的消息，不处理")
+                return                
+            content = self.agentid.get_content_from_message(message_data)
+            response = Application.call(
+                api_key=self.api_key,
+                app_id=self.app_id,
+                prompt=content
+            )
+
+            if response.status_code != HTTPStatus.OK:
+                result = f"调用失败，错误码：{response.status_code}, 错误信息：{response.message}"
+                print(f'request_id={response.request_id}')
+                print(f'code={response.status_code}')
+                print(f'message={response.message}')
+                print(f'请参考文档：https://help.aliyun.com/zh/model-studio/developer-reference/error-code')
+            else:
+                result = response.output.text
+                print(response.output.text)
+            to_aid_list = []
+            to_aid_list.append(message_data.get("sender"))
+            # 修改为直接传递字典而不是对象
+            msg_block = {
+                "type": "content",
+                "status": "success", 
+                "timestamp": int(time.time() * 1000),
+                "content": result
+            }
+            self.agentid.reply_message(message_data, msg_block)
+        except Exception as e:
+            import traceback
+            print(f"处理消息时发生错误: {e}\n完整堆栈跟踪:\n{traceback.format_exc()}")
+            
+async def main():
+    client = AmapClient()
+    print("欢迎使用高德聊天机器人 AGENT 客户端！")
+    client.agentid = client.agentid_client.load_aid("your_agent_id")  # 替换为实际的AgentID
+    try:
+        await client.chat_loop()
+    except Exception as e:
+        print(f"聊天循环出错: {e}")
+        
+if __name__ == "__main__":
+    asyncio.run(main())

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

@@ -0,0 +1,125 @@
+from datetime import datetime, timezone
+import agentcp
+from pathlib import Path  # 新增导入
+import json
+def create_financial_analyzer_json(publisherInfo):
+    """创建智能体能力、权限描述"""
+    profile_json_data = {
+        "publisherInfo": publisherInfo,
+        "avaUrl": "https://img0.baidu.com/it/u=727206602,4114969606&fm=253&fmt=auto&app=138&f=JPEG?w=285&h=285",
+        "version": "1.0.0",
+        "lastUpdated": datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ"),
+        "name": "高德地图查询智能体",
+        "description": "路线规划、导航、POI查询等功能",
+        "capabilities": {
+            "core": ["路线规划、导航、POI查询等功能"],
+            "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": True, # 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(".",seed_password="888777",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/compute_agent/agent/powershell.py

@@ -0,0 +1,228 @@
+import subprocess
+import json
+from typing import Optional, Union, List, Dict
+import tempfile
+import os
+import logging
+
+
+class PowerShellExecutor:
+    """
+    PowerShell 脚本执行模块
+
+    功能：
+    - 执行 PowerShell 命令或脚本文件
+    - 支持参数传递
+    - 捕获标准输出和错误输出
+    - 支持 JSON 结果解析
+    - 超时控制
+    - 临时脚本文件管理
+    """
+
+    def __init__(self, execution_policy: str = "RemoteSigned"):
+        """
+        初始化 PowerShell 执行器
+
+        :param execution_policy: PowerShell 执行策略 (默认: RemoteSigned)
+        """
+        self.execution_policy = execution_policy
+        self.logger = logging.getLogger("PowerShellExecutor")
+
+    def execute_command(
+        self,
+        command: str,
+        arguments: Optional[Dict[str, Union[str, int, bool]]] = None,
+        timeout: int = 60,
+        convert_to_json: bool = False,
+    ) -> Union[str, Dict]:
+        """
+        执行 PowerShell 命令
+
+        :param command: PowerShell 命令或脚本代码
+        :param arguments: 参数字典 {参数名: 值}
+        :param timeout: 超时时间(秒)
+        :param convert_to_json: 是否将输出解析为JSON
+        :return: 命令输出或解析后的JSON
+        """
+        # 构建完整的 PowerShell 命令
+        ps_command = self._build_ps_command(command, arguments)
+
+        # 执行命令
+        result = self._execute_ps(ps_command, timeout)
+
+        # 如果需要转换为 JSON
+        if convert_to_json:
+            try:
+                return json.loads(result.stdout)
+            except json.JSONDecodeError:
+                self.logger.warning("Output is not valid JSON, returning raw output")
+                return result.stdout
+        return result.stdout
+
+    def execute_script(
+        self,
+        script_path: str,
+        arguments: Optional[Dict[str, Union[str, int, bool]]] = None,
+        timeout: int = 60,
+        convert_to_json: bool = False,
+    ) -> Union[str, Dict]:
+        """
+        执行 PowerShell 脚本文件
+
+        :param script_path: PowerShell 脚本路径
+        :param arguments: 参数字典 {参数名: 值}
+        :param timeout: 超时时间(秒)
+        :param convert_to_json: 是否将输出解析为JSON
+        :return: 脚本输出或解析后的JSON
+        """
+        if not os.path.exists(script_path):
+            raise FileNotFoundError(f"PowerShell script not found: {script_path}")
+
+        # 构建执行脚本的命令
+        ps_command = f"& '{script_path}' {self._dict_to_ps_args(arguments)}"
+
+        # 执行命令
+        result = self._execute_ps(ps_command, timeout)
+
+        # 如果需要转换为 JSON
+        if convert_to_json:
+            try:
+                return json.loads(result.stdout)
+            except json.JSONDecodeError:
+                self.logger.warning("Output is not valid JSON, returning raw output")
+                return result.stdout
+        return result.stdout
+
+    def execute_temporary_script(
+        self,
+        script_content: str,
+        arguments: Optional[Dict[str, Union[str, int, bool]]] = None,
+        timeout: int = 60,
+        convert_to_json: bool = False,
+    ) -> Union[str, Dict]:
+        """
+        创建并执行临时 PowerShell 脚本
+
+        :param script_content: PowerShell 脚本内容
+        :param arguments: 参数字典 {参数名: 值}
+        :param timeout: 超时时间(秒)
+        :param convert_to_json: 是否将输出解析为JSON
+        :return: 脚本输出或解析后的JSON
+        """
+        # 创建临时脚本文件
+        with tempfile.NamedTemporaryFile(
+            suffix=".ps1", delete=False, mode="w"
+        ) as temp_script:
+            temp_script.write(script_content)
+            temp_path = temp_script.name
+
+        try:
+            result = self.execute_script(temp_path, arguments, timeout, convert_to_json)
+        finally:
+            # 清理临时文件
+            os.unlink(temp_path)
+
+        return result
+
+    def _build_ps_command(
+        self, command: str, arguments: Optional[Dict[str, Union[str, int, bool]]] = None
+    ) -> str:
+        """
+        构建完整的 PowerShell 命令
+
+        :param command: 基础命令
+        :param arguments: 参数字典
+        :return: 完整的 PowerShell 命令
+        """
+        # 如果命令是多行脚本，需要先保存到变量中
+        if "\n" in command:
+            script_block = f"{{{command}}}"
+            return f"Invoke-Command -ScriptBlock {script_block} {self._dict_to_ps_args(arguments)}"
+        else:
+            return f"{command} {self._dict_to_ps_args(arguments)}"
+
+    def _dict_to_ps_args(
+        self, arguments: Optional[Dict[str, Union[str, int, bool]]]
+    ) -> str:
+        """
+        将参数字典转换为 PowerShell 参数字符串
+
+        :param arguments: 参数字典
+        :return: PowerShell 参数字符串
+        """
+        if not arguments:
+            return ""
+
+        args = []
+        for key, value in arguments.items():
+            if isinstance(value, bool):
+                # 布尔参数处理
+                if value:
+                    args.append(f"-{key}")
+            else:
+                # 其他类型参数
+                args.append(f"-{key} {self._escape_ps_value(value)}")
+
+        return " ".join(args)
+
+    def _escape_ps_value(self, value: Union[str, int, float]) -> str:
+        """
+        转义 PowerShell 参数值
+
+        :param value: 参数值
+        :return: 转义后的字符串
+        """
+        if isinstance(value, str):
+            # 字符串需要加引号并转义内部引号
+            return f"\"{value.replace('\"', '`\"')}\""
+        else:
+            # 数字类型直接转换为字符串
+            return str(value)
+
+    def _execute_ps(self, ps_command: str, timeout: int) -> subprocess.CompletedProcess:
+        """
+        执行 PowerShell 命令
+
+        :param ps_command: PowerShell 命令
+        :param timeout: 超时时间(秒)
+        :return: 完成的过程对象
+        """
+        # 构建完整的 PowerShell 命令
+        full_command = [
+            "powershell.exe",
+            "-ExecutionPolicy",
+            self.execution_policy,
+            "-NoProfile",
+            "-NonInteractive",
+            "-Command",
+            ps_command,
+        ]
+
+        self.logger.debug(f"Executing PowerShell command: {' '.join(full_command)}")
+
+        try:
+            # 执行命令
+            result = subprocess.run(
+                full_command,
+                stdout=subprocess.PIPE,
+                stderr=subprocess.PIPE,
+                text=True,
+                timeout=timeout,
+                check=False,
+            )
+
+            # 记录错误
+            if result.returncode != 0:
+                self.logger.error(
+                    f"PowerShell command failed with exit code {result.returncode}\n"
+                    f"Error output: {result.stderr}"
+                )
+
+            return result
+
+        except subprocess.TimeoutExpired:
+            self.logger.error("PowerShell command timed out")
+            raise
+        except Exception as e:
+            self.logger.error(f"Error executing PowerShell command: {str(e)}")
+            raise

package/extensions/services/proxy/agentcp/samples/compute_agent/agent/software.py

@@ -0,0 +1,63 @@
+import os
+import requests
+import subprocess
+import zipfile
+from .tools import download_file
+
+class SoftwareDeployer:
+    def __init__(self, temp_dir="./temp"):
+        self.temp_dir = temp_dir
+        os.makedirs(temp_dir, exist_ok=True)
+
+    def deploy(self, package_url, install_args=None):
+        # 下载软件包
+        package_path = os.path.join(self.temp_dir, "package.zip")
+        self._download(package_url, package_path)
+
+        # 解压
+        extract_dir = os.path.join(self.temp_dir, "extracted")
+        self._extract(package_path, extract_dir)
+
+        # 查找安装程序
+        installer = self._find_installer(extract_dir)
+
+        # 安装
+        self._install(installer, install_args or [])
+
+        # 清理
+        self._cleanup()
+
+    def _download(self, url, save_path):
+        print(f"Downloading from {url}...")
+        download_file(url, save_path)
+
+    def _extract(self, package_path, extract_dir):
+        print("Extracting package...")
+        with zipfile.ZipFile(package_path, "r") as zipf:
+            zipf.extractall(extract_dir)
+
+    def _find_installer(self, directory):
+        for root, _, files in os.walk(directory):
+            for file in files:
+                if file.lower().endswith((".exe", ".msi")):
+                    return os.path.join(root, file)
+        raise FileNotFoundError("No installer found in package")
+
+    def _install(self, installer, args):
+        print(f"Installing {installer}...")
+        if installer.endswith(".msi"):
+            subprocess.run(["msiexec", "/i", installer, "/qn"] + args, check=True)
+        else:
+            subprocess.run([installer, "/S"] + args, check=True)
+
+    def _cleanup(self):
+        print("Cleaning up...")
+        # 安全删除临时文件
+        import shutil
+
+        shutil.rmtree(self.temp_dir)
+
+
+# 使用示例
+deployer = SoftwareDeployer()
+deployer.deploy("https://example.com/software/latest.zip")

package/extensions/services/proxy/agentcp/samples/compute_agent/agent/tools.py

@@ -0,0 +1,36 @@
+import zipfile
+import os
+import requests
+from tqdm import tqdm  # 进度条
+
+# 创建 ZIP 包
+def create_zip(output_filename, source_dir):
+    with zipfile.ZipFile(output_filename, "w", zipfile.ZIP_DEFLATED) as zipf:
+        for root, dirs, files in os.walk(source_dir):
+            for file in files:
+                file_path = os.path.join(root, file)
+                arcname = os.path.relpath(file_path, start=source_dir)
+                zipf.write(file_path, arcname)
+
+
+# 解压 ZIP 包
+def extract_zip(zip_file, extract_dir):
+    with zipfile.ZipFile(zip_file, "r") as zipf:
+        zipf.extractall(extract_dir)
+
+
+def download_file(url, filename):
+    with requests.get(url, stream=True) as r:
+        r.raise_for_status()
+        total_size = int(r.headers.get("content-length", 0))
+
+        with open(filename, "wb") as f, tqdm(
+            desc=filename,
+            total=total_size,
+            unit="iB",
+            unit_scale=True,
+            unit_divisor=1024,
+        ) as bar:
+            for chunk in r.iter_content(chunk_size=8192):
+                f.write(chunk)
+                bar.update(len(chunk))

package/extensions/services/proxy/agentcp/samples/compute_agent/browser_user.py

@@ -0,0 +1,41 @@
+import os
+from browser_use import Agent, Browser, BrowserConfig
+from langchain_openai import ChatOpenAI, OpenAI
+import asyncio
+
+# Configure the browser to connect to your Chrome instance
+browser = Browser(
+    config=BrowserConfig(
+        # Specify the path to your Chrome executable
+        # browser_binary_path="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",  # macOS path
+        # For Windows, typically: 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe'
+        # For Linux, typically: '/usr/bin/google-chrome'
+        keep_alive=True,  # Keep the browser alive after the script ends
+    )
+)
+llm = ChatOpenAI(
+    base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",
+    model="qwen-plus",
+    api_key=os.getenv("DASHSCOPE_API_KEY"),
+)
+
+# Create the agent with your configured browser
+agent = Agent(
+    task="打开京东，搜索“iphone15”，找一个价格最便宜的，但不要2手的手机，然后打开它的详情页",
+    llm=llm,
+    browser=browser,
+    planner_llm=llm,
+    page_extraction_llm=llm,
+    # 配置浏览器的代理
+)
+
+
+async def main():
+    await agent.run()
+
+    input("Press Enter to close the browser...")
+    await browser.close()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())