package com.vincent.rsf.server.ai.service.provider;

import com.vincent.rsf.server.ai.model.AiDiagnosticToolResult;
import com.vincent.rsf.server.ai.model.AiPromptContext;

public interface AiDiagnosticDataProvider {

    /**
     * 返回内部工具编码，作为本地 MCP 工具名后缀和工具配置主键。
     */
    String getToolCode();

    /**
     * 返回工具展示名称。
     */
    String getToolName();

    /**
     * 返回工具默认说明，用于工具目录展示和默认 Prompt 引导。
     */
    default String getDefaultToolPrompt() {
        return "";
    }

    /**
     * 返回工具默认顺序。
     */
    int getOrder();

    /**
     * 执行内部工具的真实业务查询，并返回摘要化结果。
     */
    AiDiagnosticToolResult buildDiagnosticData(AiPromptContext context);

}