# 获取工具详情

`GET` `/api/agent/finx/getToolDetail`

获取指定工具的完整定义，包含参数Schema和调用方式信息。响应中 toolId 为工具唯一标识（HTTP类型有值，MCP为null，用于 updateTool/deleteTool 操作）；type 字段标识工具所属服务类型（HTTP/MCP/BUILTIN）；当 type=HTTP 时，httpEndpoint 字段包含HTTP端点配置（method、path、contentType、timeout、queryParams、streaming、resultEventName），其中 streaming 标识工具是否以SSE方式连接客户端端点（默认false），resultEventName 为SSE流中作为模型观察结果的保留事件名（默认 tool_observation）；其余类型该字段为null。用于工具能力预览页面渲染。身份说明：当您通过API访问本系统时，请求头中必须传递 X-Principal-Id 以标识操作主体；当您通过页面访问本系统时，无需传递。

## 请求参数

### 请求头参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| X-Principal-Id | integer | 否 | 身份主体ID（Long类型）。通过API访问时必须传递以标识操作主体；通过页面访问时无需传递。可通过「身份主体」模块的创建接口获取。 |

### Query 参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| agentId | integer | 是 | 智能体ID，必填 |
| serviceName | string | 是 | 服务名称，必填 |
| toolName | string | 是 | 工具名称，必填 |

## 响应

### 200

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | FinxToolDetail | 响应数据 |
|     toolId | integer | - |
|     name | string | - |
|     description | string | - |
|     parameterSchema | string | - |
|     type | string | - |
|     httpEndpoint | FinxHttpEndpointInfo | - |
|         method | string | - |
|         path | string | - |
|         contentType | string | - |
|         timeout | integer | - |
|         queryParams | array | - |
|         streaming | boolean | - |
|         resultEventName | string | - |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |

### 400

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | object | 响应数据 |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |

### 500

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | object | 响应数据 |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |