SuperAPI AI 工具集

alibabacloud-dataworks-data-agent

智能体与模型

查看项目

更新于 10-15 19:54

技能介绍

用途:该技能用于通过 aliyun dataworks-public CLI 与 DataWorks Data Agent 交互,实现对话式数据分析、会话生命周期管理以及分析产物下载。

主要能力:提供 8 个 Data Agent API,包括 create-agent-session(创建会话)、prompt-agent-session(发送提问)、load-agent-session(加载历史)、list-agent-sessions(列出会话)、list-agent-session-artifacts(列出产物)、get-agent-session-artifact-meta(获取产物元信息)、get-agent-session-token-usage(查询 token 用量)、cancel-agent-session(取消会话)。支持在提问时附带数据集上下文(Meta.Context 中的 datasetUuid)和文件附件(Type 为 file,含 Name 与 Uri)。

使用方式:先确认 aliyun CLI 版本(aliyun version)与插件版本(aliyun plugin list | grep dataworks),插件过旧时执行 aliyun plugin update aliyun-cli-dataworks-public,并用 aliyun configure list 校验 profile。调用格式为 aliyun dataworks-public <action> --profile <profile> --region <region> --params '<JSON>' --user-agent AlibabaCloud-Agent-Skills/alibabacloud-dataworks-data-agent/<session-id>。典型流程为创建会话并提取 SessionId、发送提问、按需列出并下载产物、加载历史、查询 token 用量、取消会话。所有调用需携带同一工作流内生成的 UUID v4 作为 user-agent 中的 session-id。

适用场景:需要对 DataWorks 数据进行对话式分析、管理分析会话、下载分析产物或查看 token 消耗的用户。

限制:仅允许调用上述 8 个 Data Agent API,不得直接调用其他 DataWorks OpenAPI;端点仅限 *.aliyuncs.com 或 localhost;禁止读取或展示 AccessKey/Secret/SecurityToken,禁止读取 ~/.aliyun/config.json 等凭据文件;文件路径仅限用户数据文件,不得传入 /etc/、/proc/、~/.ssh/、~/.kube/、~/.aliyun/;不得修改环境变量绕过错误,不得伪造输出。创建会话失败最多重试 2 次,之后回退到 list-agent-sessions 复用非 RELEASED 会话;RELEASED 会话不可用于提问。产物路径必须先经 list-agent-session-artifacts 返回才可使用。用户意图不明确时必须先询问澄清。若用户表示尚未创建会话,须立即停止且不调用任何 API。具体收费、价格与平台支持范围暂未提供。