MaxAgent 实战课堂（一）：从开通到第一次有效提问

引言：刚开始使用MaxCompute时常会遇到这样的场景：想了解一个 MaxCompute 功能，常常要在几篇文档之间查找。遇到一条失败或运行缓慢的 SQL，还要先找到作业信息，再去查看日志。

MaxAgent 是 MaxCompute 平台的 AI 智能助手。你可以用自然语言询问产品知识，或结合具体作业和资源信息开展诊断分析。

从这一篇开始，我们会围绕日常任务介绍 MaxAgent 的使用方法。

第一课先完成一次简单体验：进入产品、确认开通和权限、提出一个问题，再核验回答中的一条关键结论。

本文适合首次使用 MaxAgent 的数据开发、运维、平台管理员和技术负责人。示例只做产品知识问答，不创建表、不执行 SQL，也不修改配置，无需准备业务数据。

为什么要使用 MaxAgent

MaxCompute 的日常工作横跨产品文档、作业日志、资源观测、成本与权限等多个入口。很多任务本身并不复杂，时间却花在寻找入口、补充上下文和来回核对上。MaxAgent 将这些场景放进自然语言对话，让使用者先描述目标，再逐步补齐项目、作业或时间范围。

降低产品学习门槛

不熟悉某个概念或功能时，可以直接用日常语言提问，不必先掌握全部命令和页面位置。MaxAgent 可以回答 MaxCompute 产品功能、使用场景和最佳实践等问题，帮助新用户更快找到继续学习和操作的方向。

让业务问题直接进入数据分析

DataAgent 是 MaxAgent 的数据分析角色，在控制台中对应"查数"。它可以在当前账号有权访问的数据范围内，用自然语言查找项目、Schema、表和分区，执行有边界的查询，分析指标、诊断异常、检查数据质量，并将结果整理为数据表、图表、仪表板或分析报告。使用者不必先知道完整表名或熟练编写 SQL，但仍需明确时间范围、指标口径和分析目标，并复核查询证据与结论。

缩短诊断与分析链路

面对 SQL 失败、运行缓慢或数据倾斜等问题，可以结合具体作业信息发起诊断。平台管理员也可以围绕成本、Quota、存储、权限和元数据开展分析。

从分析结果走向管理闭环

MaxAgent 不仅能分析问题，也已支持项目管理、Quota 管理、权限管理等操作。具备相应权限的用户可以用自然语言发起部分平台管理任务，减少在多个页面和命令之间切换的成本。

让周期性工作持续运行

对于异常作业巡检等重复任务，支持配置定时任务，并通过钉钉机器人接收结果。这样，部分工作可以从临时发问转为周期运行，再根据报告继续下钻问题。

权限沿用、敏感操作受控、过程可回看

MaxAgent 以请求者身份访问和管理资源，不会绕过现有权限。

• DataAgent 只能读取当前账号有权访问的数据，用于分析查询，对表或表数据进行操作除了验证当前账户权限还需二次确认。

• 对于项目、Quota、权限等管理操作，只有具备相应权限的用户才能发起，并需按实际页面完成确认或审批；执行前应检查目标对象、变更内容和影响范围。

• 历史对话可以回看并保留；管理操作、定时任务执行记录和 Credits 明细则为复盘过程提供其他线索，重要结论和变更结果仍需人工核验。

MaxAgent 的价值不在于替用户做所有决定，而在于把知识查询、DataAgent 数据分析、作业诊断、受控管理和周期巡检连接起来。例如，可以先通过 周期巡检发现作业异常，再结合相应能力下钻诊断；对于平台问题，还可以发起受控管理操作并核验执行结果。这样能减少查找、整理与跨页面操作的重复工作，让用户把精力放在判断、确认和处置上。不同能力的开放范围并不完全相同，本文先从适合新用户起步的产品知识问答开始。

完成标准版开通

登录 MaxCompute 控制台，在左侧导航栏找到 MaxAgent，进入独立页面。

使用 MaxAgent 前，需要先开通标准版。如果页面提示尚未开通，请根据页面引导完成标准版开通；已经开通的则可以直接开始对话。

Credits 是 MaxAgent 的用量额度。标准版 0 元开通，每月提供 300 Credits，可以先用免费额度完成体验，再根据需要购买 Credits 包。

确认账号权限

开通服务与访问项目资源是两件事。MaxAgent 涉及到读取项目基本信息、作业日志或表元数据时，会以请求者身份发起请求。请求者身份需要具备查看对应项目、日志或表信息的权限。

如果请求者身份是 RAM 用户，需要联系主账号或管理员确认相应授权，按实际任务配置所需权限。注意，能进入 MaxAgent，也不代表能查看所有项目。

本文先询问通用产品知识，不需要读取某个项目的日志或表数据。

完成第一次提问

第一次体验，可以选择一个不依赖生产数据的问题。例如，准备使用外部表前，先了解它的用途和限制。在会话输入框中发送：

请介绍 MaxCompute 外部表的适用场景、创建前提和常见限制。
请区分通用说明与不同数据源的特殊要求，并附上相关官方文档。
如果某项限制需要结合数据源或格式判断，请明确说明。

查看视频演示 >>

这个问法明确了想了解的内容、需要的依据和操作边界。预期回答应解释外部表适合什么场景、使用前需要确认什么，以及哪些限制取决于具体数据源或格式。

如果回答仍然过于宽泛，可以在同一会话中补充上下文：

我的数据存放在 OSS，暂时只希望了解读取方案。
请收窄到 OSS 外部表，说明需要确认的授权和数据格式。

查看视频演示 >>

"回答是否正确？"，核验一条事实

收到回答后，选择一条会影响后续决策的结论，回到官方文档核对。比如可以检查："使用外部表，会不会把源数据复制后存入 MaxCompute？"

MaxCompute 官方文档《外部表介绍》说明，外部表的数据存储于外部系统，使用外部表时不会将数据复制后存储在 MaxCompute。

回看历史对话

在 MaxAgent 独立页面左侧，可以找到历史会话并点击回顾，重要回答和核验依据可以复制文本或截图保存。

看懂 Credits：共享额度、个人限额和用量

Credits 是 MaxAgent 的用量单位，主要覆盖模型 Token 和 MaxAgent 实例拉起的计算资源消费。输入的问题、上下文和生成的回答都会形成消耗；提交到 MaxCompute 引擎执行任务的费用不包含在 Credits 中。本文只做知识问答；使用 DataAgent 执行 SQL 查询或后续场景实际提交 SQL 时，还需另行考虑 MaxCompute 计算资源消耗。

一个租户，也就是一个主账号及其下的相关身份，共享租户可用的 Credits。管理员可以设置租户总限额，并为 RAM User、RAM Role 等身份配置默认个人限额或单独限额。个人限额只是共享额度中的使用上限，并不代表为该身份预留了一份独立 Credits；租户可用余额、租户总限额或个人限额中的任一约束不满足，都会阻断新的 MaxAgent 请求。

Credits限额管理，可进入 MaxCompute 控制台的"智能助手 > MaxAgent管理>限额管理"进行操作。

需要查看额度与用量，可进入 MaxCompute 控制台的"智能助手 > Credits明细"，查看 Credits 总额度、已用额度和剩余额度，以及使用明细。

遇到问题，先判断卡在哪一层

• 如果页面提示尚未开通，先确认标准版开通状态。

• 如果提示无权限，确认当前登录身份和所需授权；涉及具体项目时，还要检查是否具备对应资源权限，不通过扩大授权绕过问题。

• 如果提示 Credits 不足，先区分三种情况，不要通过切换无关账号绕过配额控制。

  • 租户共享余额已经用完时，由有权限的管理员按当前站点规则购买或补充 Credits。

  • 租户仍有可用额度、但总限额已经达到上限时，检查是否需要调整租户总限额。

  • 只有当前身份达到个人限额时，再调整默认个人限额或该身份的单独限额。

• 若问题缺少项目信息、作业信息或时间范围，则先补充上下文；这类输入不完整，与权限不足、额度不足是不同的问题。

下一步：把一个问题问完整

现在打开 MaxAgent，复制示例完成提问，用官方文档核验一条结论，再回看历史会话和额度页面。完成这次练习后，可以选择一个与你工作相关、无需改动资源的问题继续体验。

maxcompute.console.aliyun.com/