MaxAgent 是 MaxCompute 平台的 AI 智能助手，为用户提供全链路自服务与智能运维能力，降低使用门槛，提升运维效率。MaxAgent 支持以自然语言方式完成作业诊断、数据查询、成本分析、资源优化、权限审计、元数据探索等场景，无需记忆复杂命令或手动查找文档，即可完成日常开发与运维工作。
声明
在使用 MaxAgent 前，请仔细阅读以下说明：
AI 生成内容仅供参考：本服务输出内容由人工智能模型生成，阿里云无法完全保证内容的安全、可靠、合规、完整和准确，生成内容不代表阿里云立场和观点。请结合实际情况谨慎判断，不建议不加核实地直接执行重要操作；若依据生成内容作出的判断或行为导致任何损失，阿里云不承担任何责任。
变更操作需谨慎：任何涉及配置修改或高风险操作（如删除、权限变更）的建议，请先在测试环境验证，再在生产环境执行。
权限边界：MaxAgent 的操作以当前登录用户身份执行，不会超越该账号的权限范围。诊断、优化、数据分析等功能涉及项目基本信息、作业日志、表元数据、表数据等，请求者身份需拥有对应权限。
数据隐私：诊断和分析功能仅读取相关作业日志、元数据等信息，不会修改或外传数据。
合法合规使用：所有使用行为由用户自行负责。请确保发布、上传或通过服务提供的任何内容合法合规，不损害社会公共秩序，不侵犯他人合法权益。
提问质量影响结果：问题越精准（附带 Instance ID、时间范围、项目名称等关键参数），诊断与分析结果越准确。
支持地域
华东1（杭州）、华东2（上海）、华北2（北京）、华北3（张家口）、华北6（乌兰察布）、华南1（深圳）、西南1（成都）、中国香港、新加坡、马来西亚（吉隆坡）、印度尼西亚（雅加达）、德国（法兰克福）、美国（硅谷）、美国（弗吉尼亚）
适用用户
用户角色 | 典型使用场景 |
数据平台管理员 | 资源管理、成本优化、权限管控、批量巡检 |
运维工程师 | 故障排查、自动化运维、LogView 分析 |
企业技术负责人 | 成本可视化、资源利用率提升、团队效率提升 |
数据开发工程师 | 作业诊断、性能优化 |
费用说明
Credits费用主要包含token和MaxAgent实例的计算资源消费，不包含提交到引擎上执行的任务如“智能取数”模块执行SQL产生的消费。
必须先开通标准版，才能正常使用MaxAgent功能。开通标准版后，后续可以按需选购Credits规格包。
售卖形式
MaxAgent推出标准版和Credits包两种售卖形式：
MaxAgent 标准版：0元开通，每个月有300 Credits免费使用。
Credits包：包括100 Credits、500 Credits、1000 Credits、5000 Credits、10000 Credits几个规格按月售卖。
MaxAgent详细费用参考文档Credits费用。
权限配置
使用 MaxAgent 的诊断、优化、数据分析等功能时，会涉及项目基本信息、作业日志、表元数据等数据，均需以请求者身份发起数据请求。请确保账号拥有相应的管控面或数据面权限。
阿里云主账号用户：可直接使用MaxAgent。
RAM用户：
使用运维（AI Ops）资源查看、作业诊断等会涉及资源数据和作业数据的功能时，需要相应的数据查看权限；
使用查数（AI Query/DataAgent）查看元数据、取数等会涉及MaxCompute表数据查看权限。
详情可参考：权限说明。
快速开始
登录MaxCompute控制台，在左上角选择地域。
在页面右上角单击MaxAgent，进入MaxAgent 独立页面，包含历史对话列表与完整的会话界面。
核心能力
MaxAgent 目前主要包括OpsAgent能力，覆盖以下核心场景，通过内置专用 Skill 自动匹配用户意图并执行。
静态知识问答
提供关于 MaxCompute 产品功能、使用场景、最佳实践等全面的知识解答，支持以自然语言方式查询产品文档。
提问示例
"MaxCompute 外部表怎么创建？"
"什么是 Tunnel？有什么传输限制？"
"MaxCompute 支持哪些数据格式？"
"如何配置 MaxCompute 的网络连接？"
使用建议
提问时尽量描述具体场景，例如附上使用环境或遇到的具体问题，有助于获得更精准的解答。
作业诊断与日志分析
单作业诊断
针对单个 SQL 作业进行失败原因分析或性能瓶颈定位。
支持的诊断类型
诊断类型
说明
失败作业诊断
对运行失败的作业进行错误分类与修复建议
慢作业诊断
对慢 SQL 进行执行瓶颈分析，给出优化建议
数据倾斜分析
识别作业中的数据倾斜节点，分析根因并推荐解决方案
UDF 性能分析
分析用户自定义函数的执行性能，识别瓶颈
提问示例
"帮我诊断这个作业：[instance_id]"
"这个 SQL 为什么跑了很慢？logview 地址：[url]"
"这个作业[instance_id]有没有数据倾斜？"
使用建议
提供 Instance ID 或 LogView 地址，可以获得更准确的诊断结果。
作业日常巡检
查看平台或项目层面的作业整体运行态势，了解失败率趋势、Top 资源消耗等。
提问示例
"最近一天项目 [project_name] 的作业失败率怎么样？"
"哪些作业消耗资源最多？"
"给我展示今天的作业运行态势"
资源与成本优化
账单与费用分析
基于计量数据，查看费用汇总、费用趋势及各计费项分布。
提问示例
"这个月的 MaxCompute 费用是多少？"
"最近 7 天的计算费用趋势是怎样的？"
"按计费项看，哪类费用占比最高？"
计算 Quota 分析与规划
分析 Quota 资源利用率、调度情况，评估容量是否充足，给出优化建议。
提问示例
"当前 Quota [quota_name] 资源够用吗？有没有风险？"
"帮我分析 [quota_name] 的利用率"
"Quota [quota_name] 调度配置是否合理？有没有优化建议？"
存储分析与优化
分析表级、分区级存储分布，识别存储大户，推荐存储优化策略。
提问示例
"哪些表占用存储最多？"
"项目 [project_name] 的存储用量是多少？有没有优化空间？"
"有哪些冷数据可以进行分层存储？"
智能优化推荐
物化视图优化
分析物化视图和 AutoMV 的使用状况与收益，推荐候选物化视图。
提问示例
"有哪些 MV 推荐需要关注？"
"当前 AutoMV 的命中率和收益怎么样？"
"哪些查询适合创建物化视图？"
表聚簇优化
推荐适合聚簇的表，评估已聚簇表的收益。
提问示例
"有哪些表适合做聚簇优化？"
"帮我分析 [table_name] 的聚簇收益"
"当前已有聚簇表的效果怎么样？"
权限安全审计
审计用户、角色和 ACL 权限配置，识别权限过大、ACL 异常或跨项目信任风险。
提问示例
"帮我审计项目 [project_name] 的权限配置"
"列出拥有项目admin或super_administrator角色权限的所有用户以及对应的项目"
"有没有可疑的跨项目信任配置？"
元数据探索
浏览项目、表、字段、分区、函数等元数据信息，了解数据结构。
提问示例
"项目 [project_name] 下有哪些表？"
"表 [table_name] 的字段结构是什么样的？"
"相关[业务名称或描述]的表有哪些？"
"查一下 [table_name] 的分区列表"
提问技巧
准确描述想了解什么，或要解决什么问题，避免过于模糊。
不推荐："我的作业有问题"推荐："项目xxxx的作业Instance ID运行失败，帮我分析原因"
推荐：
提供关键上下文：附上 Instance ID、项目名称、Quota 名称、时间范围等信息，有助于 MaxAgent 精准定位。
单次聚焦一个问题：避免在一条消息中询问多个不相关的问题，逐步推进效果更好。
参考示例模板：
场景 | 提问模板 |
作业诊断 | "帮我诊断 instance_id=[xxx] 的作业失败原因" |
费用查询 | "帮我分析 [项目名] 最近 30 天的计算费用趋势" |
Quota 分析 | "分析 [quota_name] 的利用率，并给出优化建议" |
权限审计 | "审计 [project_name] 项目内是否有权限过大的用户" |
存储分析 | "列出 [project_name] 下占用存储最多的前 10 张表" |
产品问答 | "MaxCompute 的分层存储如何配置？有哪些注意事项？" |
查看历史对话
MaxAgent 支持查看历史对话记录，便于回溯以往的诊断结果或分析报告。在 MaxAgent 独立页面左侧栏单击可查看所有历史会话。
定时任务
定时任务适用于周期性自动化运维和数据分析场景。配置定时任务后，MaxAgent 将按计划自动执行巡检、报表等任务，并通过机器人将结果报告推送至目标群或个人，降低人工巡检成本，缩短问题响应时间。
定时任务适用于以下场景：
日常巡检：自动巡检项目和作业健康状况，变被动响应为主动发现。
周期性报表：自动生成 Quota 利用率日报、成本分析报表等，减少人工统计工作。
信息推送：通过机器人自动推送关键报告，缩短问题响应时间。
内置模板
MaxAgent 提供以下内置任务模板。支持直接选择模板快速创建定时任务。
任务模板 | 建议执行频率 | 适用用户 | 场景说明 |
异常作业日巡检 | 每日 | 数据平台管理员、运维工程师 | 每日自动巡检 MaxCompute 项目或 Quota 维度的作业健康状况，自动识别失败作业、异常慢作业、资源使用异常作业等，输出结构化的巡检报告，帮助迅速发现并处理生产异常，降低故障影响面。 |
计算 Quota 资源利用率日报 | 每日 | 数据平台管理员、企业技术负责人 | 每日自动分析各 Quota 的资源利用率、调度情况和排队状态，从 CU（计算单元）利用率峰谷特征、排队时长、调度路由匹配度等维度综合评估，输出容量规划建议（含弹性预留 CU 分时配置建议），帮助实现资源的精细化管控和成本优化。 |
存储成本周度优化 | 每周或每月 | 数据平台管理员、企业技术负责人 | 每周自动分析项目维度的存储用量分布、成本趋势和优化空间，从表级或分区级存储分布入手，识别冷数据、重复数据、过期数据等浪费点，推荐生命周期管理和分层存储策略，量化优化收益预期，帮助企业持续降低存储成本。 |
计算成本月度分析报表 | 每周或每月 | 企业技术负责人、数据平台管理员 | 每月自动汇总计算资源消耗和费用情况，从费用总览、计费项分布、Top 消费者归因、费用趋势等维度进行全面分析，识别成本浪费热点，输出精细化降本建议，支撑预算管理和成本治理。 |
权限安全周审计 | 每周 | 数据平台管理员、安全运维人员 | 每周自动审计 MaxCompute 租户及项目级别的权限配置，检查权限过大、ACL 异常、跨项目信任风险、长期未使用的高权限账号等安全隐患，输出风险清单和整改建议，帮助满足数据安全合规要求。 |
NL2SQL（自然语言转 SQL）定时数据查询 | - | 数据开发工程师、业务分析师 | 通过自然语言描述定期执行的数据查询，MaxAgent 自动将自然语言转换为 SQL 并在指定项目中执行，定时产出业务数据报告。适用于日常业务指标监控、数据周报自动生成、定期数据导出等场景。 |
创建定时任务
登录MaxCompute控制台，在左上角选择地域。
在左侧导航栏，选择。在MaxAgent独立页面的左侧，单击定时任务。
在定时任务页面，单击右侧新建定时任务并在弹出的对话框中配置以下参数：
任务名称：自定义任务名称，例如“XXXX 项目每日异常作业巡检”。
计划时间：选择执行频率（每小时、每日、每周一、每月 1 日）及执行时间点。
任务指令：配置任务执行的内容，自行编写提示词，描述需要执行的巡检、分析或查询任务。
通知渠道：选择已配置的机器人。机器人配置方法请参见机器人配置章节。任务执行完成后，结果报告将自动推送至目标群或个人。
单击确定，完成定时任务创建。
也可以在模版广场选择适用的模板，进入编辑页面，编辑相应内容并单击确定，快速创建定时任务。
查看执行记录与执行结果
定时任务创建完成后，将按计划时间自动执行。您可以查看任务的每次执行记录及详细结果。
管理定时任务
定时任务列表展示任务名称、计划时间、任务 Owner、启动状态、任务描述等信息，并支持以下操作：
操作 | 说明 |
执行记录 | 查看任务的历史执行记录与执行结果 |
编辑 | 修改任务名称、计划时间、任务内容、推送渠道等配置 |
手动执行 | 立即触发一次任务执行，无需等待计划时间 |
关闭/开启 | 暂停或恢复任务的定时执行 |
删除 | 删除定时任务 |
执行机制与安全说明
执行身份：定时任务以任务 Owner 的身份执行，仅能访问 Owner 拥有权限的项目和数据。
结果推送：任务执行完成后，结果将按报告模板格式化，并支持通过配置的机器人推送至目标群或个人。
Credits 消耗：定时任务的 Credits 消耗遵循统一的计量规则，每次执行后记录消耗明细。在控制台的页面查看定时任务的累计消耗。Credits 余额不足时，定时任务将执行失败。
Credits 限额管理
MaxAgent 的 Credits 由租户下所有子账号、RAM 用户与 RAM 角色共享使用。管理员（主账号或具备 MaxAgent 管理权限的 RAM 用户）可通过限额管理为不同身份设置 Credits 消费上限，防止单一账号过度消耗，实现部门或成员级别的成本控制。
Credits 限额按自然月为周期，每月 1 日 00:00 重置已用额度。限额管理包含三个配置项：总限额、个人默认限额、个人限额明细。
配额项 | 作用范围 | 说明 |
总限额 | 租户下所有身份 | 开启用尽即停， Credits 包额度用尽时，停止受理新的 MaxAgent 会话请求。若关闭用尽即停，则上限额度包括后付费总限额+包额度。 |
个人默认限额 | 未单独配置限额的所有成员 | 为未单独配置限额的成员设置每个自然月的默认 Credits 上限。填0表示禁止使用，留空表示不限制。 |
个人限额明细 | 单独配置的 RAM 用户 / RAM 角色 | 为指定身份单独配置每个自然月的 Credits 消费上限，优先级高于个人默认限额。填0表示禁止使用，留空表示不限制。 |
个人限额优先于个人默认限额。若某身份已在个人限额明细中单独配置，则按单独配置的上限执行；否则按个人默认限额执行；若个人限额为空，则该身份不受个人限额约束，仅受总限额约束。
配置入口：登录MaxCompute控制台，在左侧导航栏选择。
资源观测与用量
登录MaxCompute控制台，在左侧导航栏选择，可查看当前购买的所有未到期 MaxAgent 订单实例详情和Credits使用明细。
查看 MaxAgent 订单实例信息
MaxAgent 实例详情包括：
订单实例 ID、规格
Credits 总额度、已用额度、剩余额度
实例开始时间与到期时间
查看 Credits 使用明细
Credits 使用明细支持按时间、实例 ID、会话请求者进行搜索，同时支持按实例 ID或会话请求者进行聚合展示，便于查看和统计 Credits 消耗情况。
非聚合模式下，明细列表包含使用时间、订单实例 ID、Agent 类型、Requester（含 User Name 和 UID）、Request ID（对应一次请求）、Credits 用量。
聚合模式下，列表包含聚合维度、记录数和 Credits 总数，适用于统计各请求者或订单实例 ID 在指定时间段内的 Credits 消耗。
机器人配置
MaxAgent打通钉钉（后续还会支持飞书、企业微信等）机器人通道，实现“聊天即服务”的交互，以及免控制台登录、移动闭环。
若机器人配置了IP白名单，那么也需要配置MaxAgent的出口IP，否则将无法正常使用，MaxAgent的出口IP如下：
地域 | IP |
cn-beijing | 39.96.91.188 |
cn-shanghai | 47.102.46.190 |
cn-hangzhou | 120.26.251.232 |
cn-chengdu | 8.137.169.192 |
cn-shenzhen | 39.108.66.251 |
cn-zhangjiakou | 47.92.119.78 |
cn-wulanchabu | 8.130.23.158 |
常见问题
Q：MaxAgent 会自动修改我的配置或数据吗？
A：不会。MaxAgent 当前主要提供诊断、分析与优化建议功能，不会自动执行任何配置变更或数据操作。所有涉及变更的操作均需用户主动确认并手动执行。
Q：Credits 用完了怎么办？
A：Credits 用尽后，会话将不可提交，系统会提示您前往购买。您可在购买页中购买 Credits 包进行补充。
Q：如何让 MaxAgent 的回答更准确？
A：建议提问时附上具体的 Instance ID、Project 名称、Quota 名称、时间范围等上下文信息；针对具体问题逐步提问，而非一次提多个不相关问题；遇到不准确的回答时，可以补充更多信息后重新提问。
Q：子账号能使用 MaxAgent 吗？
A：可以，但子账号需要主账号授予相应的 RAM 权限，并且只能访问其权限范围内的资源和数据。
Q：MaxAgent 支持哪些 MaxCompute 作业类型的诊断？
A：目前已支持 SQL 作业的诊断与 LogView 解读，Spark 及 MapReduce（MF）作业诊断能力正在规划中，后续将陆续支持。