编写MiniMax平台Agent需三步：先明确定义角色与能力边界，再强制标准化输入结构，最后锁定可解析输出格式。具体包括声明身份、列出禁用操作、明确三项核心能力；要求JSON输入含非空query键并校验；输出仅限名为run的Python函数，返回含result和status键的dict。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在MiniMax平台编写Agent时，必须让模型准确理解任务目标、输入约束和输出格式，否则生成的代码无法通过编译或运行失败。
明确声明Agent角色与能力边界
第一步：在system prompt开头用一句话定义Agent身份，例如“你是一个专用于解析用户自然语言查询并生成Python函数的代码生成Agent”。
第二步：紧接着列出该Agent【不可执行的操作】，如“不调用外部API”“不读取本地文件”“不使用time.sleep()”——这些限制必须显式写出，否则模型可能自行引入非法调用。
第三步：用分号分隔三项核心能力，例如：“能接收JSON格式输入；能输出合法Python 3.9语法；能处理字符串、数字、布尔值三种基础类型”。避免用“可以”“能够”等模糊动词，全部用“能”字统一表述。
终端本地、Git 原生 AI 结对编程 SOP，使用 Aider（git work‑tree + tree‑sitter repo‑map + edit‑format + 人机交互 REPL）。在编辑时使用。
输入结构必须强制标准化
方法一：要求用户始终以{"query": "xxx", "context": {...}}格式提交请求。若用户漏传context字段，Agent需返回错误提示而非尝试猜测。
方法二：在system prompt中写明“所有输入必含query键，且其值为非空字符串”，并在代码生成前插入校验逻辑：if not isinstance(input_data.get('query'), str) or not input_data['query'].strip(): raise ValueError("query must be a non-empty string")。
输出格式锁定为可解析结构
在prompt末尾添加硬性指令：“只输出一个合法Python函数，函数名为run，参数为input_data: dict，返回值为dict类型，键必须包含result和status，禁止任何注释、说明文字、示例或额外print语句。”
这一步操作起来很简单，直接把上述句子粘贴到prompt最后即可。但若遗漏“只输出一个合法Python函数”这个限定，模型常会补上测试用例或文档字符串，导致解析失败。
