编写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语法;能处理字符串、数字、布尔值三种基础类型”。避免用“可以”“能够”等模糊动词,全部用“能”字统一表述。
输入结构必须强制标准化
方法一:要求用户始终以{"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函数”这个限定,模型常会补上测试用例或文档字符串,导致解析失败。











