MiniMax Mcporter Tools

目的

这个 skill 用来教 agent 通过 mcporter 使用两个 MiniMax 工具：

• MiniMax.web_search
• MiniMax.understand_image

mcporter 是接入层，不是工具调用命名空间。实际调用时必须使用 MiniMax.*，也就是：

• call MiniMax.web_search ...
• call MiniMax.understand_image ...

不要编造 mcporter.web_search、mcporter.understand_image 这类不存在的调用形式。

当任务依赖实时网页信息，或必须根据图片内容作答时，应使用这个 skill，而不是凭记忆直接回答。

官方工具说明整理在 references/minimax-tools.md。主 SKILL 保留规则和流程，细节说明放在 reference 中按需加载。

何时使用

遇到以下任一情况时使用本 skill：

• The user asks for real-time, recent, or external information from the internet.
• The task requires checking news, prices, releases, public web pages, or search results.
• The user provides an image and asks what it contains.
• The task requires OCR, UI screenshot reading, visual inspection, or extracting text or structured facts from an image.
• The task references a local image path, image URL, screenshot, or uploaded picture.

强约束：

• 凡是“实时、最近、在线、外部网页信息”相关请求，必须先调用 MiniMax.web_search，不得直接凭参数知识或训练记忆作答。
• 凡是“图片里有什么、截图报错、OCR、提取图片文字、分析界面、识别图表”相关请求，必须先调用 MiniMax.understand_image。
• 如果任务同时涉及网页检索和图片分析，先检索，再按需要继续做图片理解。

工具规则

MiniMax.web_search

凡是需要搜索实时或外部网页信息时，必须使用这个工具。

输入规则：

• Pass a short search query, usually 3 to 5 keywords.
• For time-sensitive queries, include the current year or date when useful.
• If the first search is weak, rephrase the query and search again.

输出处理：

• Prioritize organic results.
• Use related_searches to reformulate poor queries.
• Check base_resp.status_code and base_resp.status_msg before trusting the results.
• Summarize findings with source awareness instead of copying snippets blindly.

MiniMax.understand_image

凡是需要分析、描述、读取或提取图片信息时，必须使用这个工具，包括用户提供图片和任务过程中的相关图片。

输入规则：

• Provide a precise prompt that says what to extract or inspect.
• Supported image formats are JPEG, PNG, and WebP only.
• image_source may be an http or https URL, a relative path, or an absolute path.
• If the input path starts with @, strip the @ before calling the tool.

输出处理：

• Ask for the exact data needed: text, layout, labels, UI elements, errors, charts, or visual differences.
• If the image is ambiguous, run a second call with a narrower prompt.
• Do not invent text that the image analysis did not return.

执行流程

1. 先判断任务类型。 确认这是网页检索、图片分析，还是两者都需要。

2. 选对工具。 实时网页信息用 MiniMax.web_search，图片内容用 MiniMax.understand_image。

3. 构造参数。 搜索词保持短而准；图片提示词要明确要提取什么；图片路径若以 @ 开头，先去掉 @。

4. 通过 mcporter 调用工具。 但实际调用名必须是 MiniMax.*，不能写成 mcporter.*。

5. 检查结果质量。 搜索要看状态码和结果相关性；图片要确认格式受支持、提示词是否足够具体。

6. 需要时重试一次。 搜索词不准就改关键词；图片分析太泛就缩小目标。

7. 基于工具结果作答。 只总结工具返回的内容，必要时说明不确定性，不要补写未经验证的事实。

决策规则

• 用户要价格、新闻、最近事件、产品更新、公开网页事实，用 MiniMax.web_search。
• 用户要看截图、识别图片、读取图片文字、解释图表，用 MiniMax.understand_image。
• 如果是“先搜网页，再分析图片”，两个工具串联使用。
• 如果信息已经完整存在于工作区文本里，且不依赖实时网页或图片，则不需要本 skill。

调用格式

命名规则：

• Use mcporter when describing the integration environment or skill scope.
• Use MiniMax.web_search and MiniMax.understand_image in actual tool calls.

Web search

call MiniMax.web_search query="黄金价格"

更多示例：

call MiniMax.web_search query="OpenAI GPT-5.4 release notes 2026"
call MiniMax.web_search query="macOS Sequoia latest update"

Image understanding

call MiniMax.understand_image prompt="提取图片中的全部文字，并标出关键数字" image_source="/absolute/path/to/image.png"

更多示例：

call MiniMax.understand_image prompt="描述这个界面的主要布局、按钮和报错信息" image_source="https://example.com/screenshot.webp"
call MiniMax.understand_image prompt="识别图表中的标题、坐标轴和趋势" image_source="images/chart.png"

质量检查

调用前：

• Confirm the task actually needs web or image capabilities.
• Confirm the chosen tool matches the job.
• Confirm image format support for understand_image.
• Remove a leading @ from image paths.

调用后：

• Check whether the output directly answers the user request.
• Retry once if the search results are irrelevant or the image prompt was too broad.
• Separate observed facts from inference.
• Keep the final answer concise and grounded in the returned result.

失败处理

• If web_search returns weak results, rewrite the query with clearer nouns, product names, locations, or dates.
• If understand_image returns a vague description, ask for extraction of a smaller target such as text, error message, chart title, or a specific region.
• If the file format is unsupported, ask the user for a JPEG, PNG, or WebP version.

可直接触发这个 Skill 的提示词

• Use MiniMax 查一下今天的黄金价格。
• 用 MiniMax 搜最近的 macOS 更新说明。
• 用 MiniMax 分析这张截图里有什么报错。
• 读取这张图片中的文字并总结重点。
• 先搜索某个页面，再解释页面截图中的信息。