---
name: vectcut-api-search
description: "检索 VectCut API 最新接口说明。只要用户提到“查接口/找 API/参数说明/最新文档/endpoint/search vectcut api”，务必使用本技能；本技能直接联网读取 https://docs.vectcut.com/llms.txt 作为全量索引入口，并按需抓取对应 Markdown/JSON/YAML 文档，不依赖本地检索脚本。"
---

# VectCut API Search Skill

用于在线检索 VectCut 接口文档，并按用户问题返回最新、可追溯的接口信息。

固定入口（必须使用）：
- `https://docs.vectcut.com/llms.txt`

## 适用场景

- 用户要查某个接口是否存在
- 用户要确认参数、返回字段、任务状态查询方式
- 用户要对比多个相近接口（如同步/异步、提交/查询）
- 用户明确要求“最新描述”“在线文档为准”

## 执行原则

1. **先联网读取入口**：先抓取 `llms.txt`，不要依赖本地过期副本。
2. **再按需抓取详情**：从入口中筛选相关接口，再读取对应详情页。
3. **结构化输出**：优先返回接口名、URL、用途、关键参数/状态字段。
4. **可追溯**：给出来源链接，方便用户点击复核。

## 快速执行

- 第一步：读取 `https://docs.vectcut.com/llms.txt`
- 第二步：从索引里定位相关 API 文档链接
- 第三步：继续抓取命中的文档详情页
- 第四步：整理输出最相关的接口、参数和来源链接

## 建议回答格式

- `命中接口`
- `用途概述`
- `关键字段/参数`
- `文档链接`
- `补充说明（如异步任务的 task_status 配对接口）`

## 注意事项

- 文档页内容可能较长，优先提取与用户问题直接相关的段落。
- 若用户问题过于宽泛，先给 Top 候选，再建议进一步限定关键词。
- 若用户只是想先了解“有哪些能力”，可先概览 `llms.txt` 中 API Docs 的目录，再深入单个接口详情。
