用minimax agent写代码需四步:配置环境(安装sdk、设api密钥)、初始化agent(必填model参数)、定义工具(装饰器或tooldefinition,parameters须合规)、运行流程(传messages和tools,依tool_calls迭代执行)。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

用MiniMax Agent写代码需要先配置开发环境、创建Agent实例、定义工具集与执行逻辑,最后调用run方法触发自动编码流程。整个过程依赖正确初始化模型参数和工具函数签名,缺一不可。
安装并配置MiniMax SDK
打开终端,执行 pip install minimax-api-sdk 安装官方SDK。这一步必须在Python 3.9及以上版本中进行,低版本会因typing模块兼容性问题导致后续init失败。
从MiniMax控制台获取API Key和Group ID,保存为环境变量:export MINIMAX_API_KEY="your_key_here" && export MINIMAX_GROUP_ID="your_group_id"。
验证配置是否生效:python -c "import minimax; print(minimax.__version__)" → 若输出版本号即成功。
初始化Agent实例
导入必要模块:from minimax import Agent, ToolDefinition。
创建Agent对象时,【必须传入model参数,如"abab6.5s"或"abab7",否则run会静默返回空结果】。
使用APIDot进行MiniMax Music 2.6 API工作流程,包括AI音乐生成、歌词创作、器乐制作、音频导出规划、异步任务提交、任务ID...
指定system_prompt控制Agent行为倾向,例如设置“你是一个专注Python后端开发的工程师,只生成可运行代码,不解释原理”。
定义可调用工具函数
方法一:用@tool装饰器声明函数
def search_pypi(package_name: str) -> str:
"""查询PyPI上包的最新版本"""
return requests.get(f"https://pypi.org/pypi/{package_name}/json").json()["info"]["version"]
search_pypi = tool(search_pypi)
方法二:手动构造ToolDefinition对象
tool_def = ToolDefinition(
name="execute_python",
description="执行一段Python代码并返回stdout",
parameters={...} # 必须严格匹配JSON Schema格式
)
【parameters字段若不符合OpenAPI 3.0规范,Agent会在调用前直接跳过该工具】
组装并运行Agent
第一步:将所有ToolDefinition实例放入列表 tools = [search_pypi_tool, execute_python_tool]。
第二步:构建messages输入,格式为[{"role": "user", "content": "写一个计算斐波那契第20项的函数"}]。
第三步:调用 agent.run(messages=messages, tools=tools) → 返回包含text和tool_calls字段的Response对象。
第四步:检查response.tool_calls是否非空,若有,则按顺序执行对应工具函数,再将结果封装为tool_result消息追加进messages,重新调用run完成迭代。










