generate_task_report_png
Generate PNG map visualizations for M-line task reports from GS cleaning robots using serial number and report ID to document cleaning operations and navigation paths.
Instructions
Generates a PNG map for M-line task report.
Args:
serial_number: The serial number of the target robot.
report_id: The ID of the task report.
Returns:
A dictionary containing the map generation result.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| serial_number | Yes | ||
| report_id | Yes |
Implementation Reference
- src/gs_openapi/main.py:224-235 (handler)MCP tool handler for 'generate_task_report_png'. This is the function executed when the tool is called, decorated with @mcp.tool() for automatic registration and schema inference from types/docstring. Delegates to core implementation.@mcp.tool() async def generate_task_report_png(serial_number: str, report_id: str): """Generates a PNG map for M-line task report. Args: serial_number: The serial number of the target robot. report_id: The ID of the task report. Returns: A dictionary containing the map generation result. """ return await mcp.generate_task_report_png(serial_number=serial_number, report_id=report_id)
- Core helper method in GausiumMCP class implementing the tool logic: validates inputs and calls the underlying Gausium OpenAPI endpoint via GausiumAPIClient.async def generate_task_report_png( self, serial_number: str, report_id: str ) -> Dict[str, Any]: """ M线任务报告地图生成。 Args: serial_number: 机器人序列号 report_id: 报告ID Returns: 地图生成结果 Raises: ValueError: 参数为空 httpx.HTTPStatusError: API调用错误 httpx.RequestError: 网络问题 """ if not serial_number: raise ValueError("Serial number cannot be empty") if not report_id: raise ValueError("Report ID cannot be empty") async with GausiumAPIClient() as client: return await client.call_endpoint( 'generate_task_report_png', path_params={ 'serial_number': serial_number, 'report_id': report_id } )
- API endpoint schema/definition for the underlying generate_task_report_png endpoint, specifying path parameters (serial_number, report_id), method, version, used by the API client.'generate_task_report_png': APIEndpoint( name="generate_task_report_png", path="robots/{serial_number}/taskReports/{report_id}/map", method=HTTPMethod.GET, version=APIVersion.V1_ALPHA1, description="M线任务报告地图生成" ),