> For the complete documentation index, see [llms.txt](https://docs.goassay.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.goassay.ai/list-your-api/zh/jin-jie/request-a-new-tool.md).

# 申请新工具

请 Assay 添加目录工具，并查看团队回复。

目录中没有描述 API 返回内容的工具时，可以请 Assay 添加。新增的目录工具也可以有其他提供方，为客户提供备用选择。要定义仅由你提供的工具，请使用[或者：发布你自己的 API](/list-your-api/zh/ru-men/publish-your-own-api.md)。

{% hint style="info" %}
\*\*开始前：\*\*按[上架目录中的工具](/list-your-api/zh/ru-men/list-a-catalogue-tool.md)检查目录，避免申请已有适用工具。
{% endhint %}

## 操作步骤

{% stepper %}
{% step %}

### 打开申请表单

打开 **Listings → Tool requests**，选择 **Request a tool**。

<figure><img src="https://2968587239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEVw4IWiK1TgVNFeMYjWm%2Fuploads%2Fgit-blob-a540b595e13ea7e1f42b4d98cabd202b3c20e891%2Fcheck-your-inbox-3.png?alt=media" alt="Tool requests 页面，已标出 Request a tool"><figcaption><p>申请目录尚未覆盖的工具。</p></figcaption></figure>
{% endstep %}

{% step %}

### 描述你提供的答案

输入 **Tool name** 和 **What it returns**。使用简短名称，描述有用的答案，例如某个城市的空气质量指数和污染物水平。不要在表单中放入密钥、密码或客户信息。

<figure><img src="https://2968587239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEVw4IWiK1TgVNFeMYjWm%2Fuploads%2Fgit-blob-ff12b3715ddcbff2c484dc6a53636f08479f9b08%2Frequest-a-new-tool-2.png?alt=media" alt="Request a tool 表单，已填写 Daily air quality 和答案描述"><figcaption><p>说明工具应该返回什么。</p></figcaption></figure>

选择 **Send request**。这会将申请发送给 Assay 团队，不会创建或发布上架项。
{% endstep %}

{% step %}

### 保留确认信息

检查是否显示 **Request sent**。Assay 争取在 2 个工作日内回复。这是响应目标，不保证届时已添加工具。选择 **See your requests** 跟进。

<figure><img src="https://2968587239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEVw4IWiK1TgVNFeMYjWm%2Fuploads%2Fgit-blob-57d12bac398dd4dd7014cd221f6ecb281eb75760%2Frequest-a-new-tool-3.png?alt=media" alt="Request sent 确认信息，已标出 See your requests"><figcaption><p>回复会显示在 Tool requests。</p></figcaption></figure>
{% endstep %}

{% step %}

### 打开申请，跟进回复

返回 **Listings → Tool requests**，选择对应行。**Ticket** 显示 **Handled by**、**First response due** 和 **First responded**。时间使用 UTC。申请作出决定后，阅读 **Accepted** 或 **Declined**，以及 **What was filed** 下的说明。

请在这里阅读回复。工具申请不会发送 Inbox 通知。如果申请被接受，请按说明操作；新工具可用后，按[上架目录中的工具](/list-your-api/zh/ru-men/list-a-catalogue-tool.md)操作。

<figure><img src="https://2968587239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEVw4IWiK1TgVNFeMYjWm%2Fuploads%2Fgit-blob-1318bf75f161d61670c6a6e9ea79f5df3a5bf5c5%2Frequest-a-new-tool-4.png?alt=media" alt="Daily air quality 申请详情，已标出 Ticket 卡片"><figcaption><p>打开同一申请，查看负责人、时间和最终决定。</p></figcaption></figure>
{% endstep %}
{% endstepper %}

## 确认是否成功

申请显示在 **Tool requests** 中。**Waiting for Assay** 表示已提交；**Being reviewed** 表示已确认收到。**Accepted** 或 **Declined** 记录决定。你可以在这里提交和阅读申请，但没有回复编辑器或状态控件。

<figure><img src="https://2968587239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEVw4IWiK1TgVNFeMYjWm%2Fuploads%2Fgit-blob-0f92993660e782c7e6334a5a50fad98f14aeaf25%2Frequest-a-new-tool-5.png?alt=media" alt="已保存的 Daily air quality 申请，显示 Waiting for Assay 和 Reply due in 2d"><figcaption><p>保存的行确认 Assay 已收到申请。</p></figcaption></figure>

## 遇到问题时

| 你看到的情况                                            | 处理方式                                      |
| ------------------------------------------------- | ----------------------------------------- |
| **Give the tool a name and say what it returns.** | 同时填写 **Tool name** 和 **What it returns**。 |
| **The API address must start with https\://.**    | 使用公开 HTTPS 地址，或将可选字段留空。                   |
| **Calls a month must be a whole number.**         | 只输入数字，或留空。                                |
| **Overdue**                                       | 打开现有申请检查回复。此徽标表示已超过首次回复目标时间，不表示申请被拒。      |
| **The request could not be sent. Try again.**     | 重试，并在再次发送申请前检查列表。                         |

<details>

<summary>可选：添加地址和预期流量</summary>

申请表单中的 **Your API address (optional)** 可帮助 Assay 了解服务。使用 HTTPS，不要包含凭据。**Calls a month you expect (optional)** 接受整数。提交申请不必填写这两个字段。

</details>

## 进一步了解

* [或者：发布你自己的 API](/list-your-api/zh/ru-men/publish-your-own-api.md)：如果你想自己定义并提供该工具。

## 下一步

* [故障排除](/list-your-api/zh/bang-zhu/troubleshooting.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.goassay.ai/list-your-api/zh/jin-jie/request-a-new-tool.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.