SuperAPI AI 工具集

amazon-workspaces-agent-access

智能体与模型

查看项目

更新于 10-15 17:22

技能介绍

用途:为 AI 智能体提供连接 Amazon WorkSpaces Applications(AppStream 2.0)远程 Windows 桌面并操控桌面应用的领域知识。Agent Access 仅支持 MCP,没有可调用桌面工具的 AWS CLI/SDK 命令;CLI/SDK 仅用于配置(如 appstream create-streaming-url、fleet/stack 配置)。

主要能力:通过托管 MCP 服务器驱动桌面,工具包括 screenshot、left_click、type_text 等,具体工具集以 tools-reference 为准。连接方式为 Streamable HTTP,端点形如 https://agentaccess-mcp.{region}.api.aws/mcp,使用服务名 agentaccess-mcp 进行 SigV4 签名;推荐用 mcp-proxy-for-aws(Python)作传输层,负责签名与 DELETE 生命周期。非域加入的 fleet 通过 X-Amzn-AgentAccess-Streaming-Session-Url 头传流式会话 URL;域加入 fleet 改用 MCP meta 键传递 SAML 断言与 stack ARN。连接模式由 HTTP 头 X-Amzn-AgentAccess-Connect-Mode 选择 BLOCKING(默认)或 POLLING,不是工具参数;POLLING 下先只返回 connection_status,轮询至 CONNECTED 后才返回完整桌面工具集。会话过期由 X-Amzn-AgentAccess-Expire-Streaming-Session-On-Delete 头控制。转发的工具按服务器命名空间化为 forwarded__<server-name>___<tool-name>。

使用方式:先由管理员在 stack 的 AgentAccessConfig 中启用所需能力(COMPUTER_INPUT、COMPUTER_VISION、FORWARD_MCP_TOOLS 相互独立),再由智能体按签名方式连接并调用工具。该技能可两种方式加载:通过 AWS MCP retrieve_skill 工具加载时需用 file 参数取回参考文件,不要本地读取;本地安装时可从技能目录用相对路径读取。

限制与安全:智能体以调用者 AWS 身份运行,应仅授予所需 agentaccess-mcp 动作并用 StackArn 条件限定,避免 agentaccess-mcp:*。截图可能含敏感数据,需按最小权限处理存储加密与访问。工具转发会在实例上执行代码,仅安装受信服务器并限制 CallForwardedTool。建议启用 CloudTrail 数据事件审计,用 UserControlMode: VIEW_STOP 保留人工干预,保护 SAML 等联合认证材料,不记录断言。区域端点、功能可用性与配额可能变化,精确信息需查阅当前官方文档。具体细节暂未提供。