generate_task_report_png

Create a PNG map visualization for robot task reports to document cleaning routes and performance data for analysis.

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/mcp/gausium_mcp.py:630-663 (handler)

Core handler implementation for the generate_task_report_png MCP tool. Calls the Gausium API to generate the PNG report map.

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
            }
        )

src/gs_openapi/main.py:225-236 (registration)

MCP tool registration using @mcp.tool() decorator. Defines the tool schema via parameters and docstring, delegates to the core handler.

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)

src/gs_openapi/core/endpoints.py:222-228 (helper)

API endpoint configuration used by the GausiumAPIClient in the handler to call the correct path and method.

'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线任务报告地图生成"
),

GS Robot MCP Server