搜索方法
按关键词查找能完成某件事的平台方法,公开、无需鉴权、不计费。
/meta/v1/methods● 支持请求参数
qstring可选query: Words to look for, for example `list agents` or `create table`. Matched against method name, summary and description; every word must match when the query has two words or fewer, otherwise at least 60% of them. Omit to list methods without ranking.
limitinteger可选query: Maximum methods returned. Without q, defaults to 50 and accepts 1–200. Search with q defaults to 20 and accepts 1–50. Out-of-range values return 400 INVALID_PARAMS.
after_idstring可选query: Return names lexically after this method name, usually last_id from the previous page. Ignored when q is present. An empty or expired cursor still uses lexical ordering.
返回
200
非空 q 按方法名、摘要和描述的相关度搜索,词序和大小写不影响匹配;limit 为 1 到 50 的整数,默认 20。不带 q 或 q 全为空白时按方法名排序列出,limit 为 1 到 200 的整数,默认 50;has_more 为 true 时将 last_id 原样作为 after_id 取下一页。搜索时忽略 after_id。limit 越界返回 400 INVALID_PARAMS。目录只包含平台方法(praxis.*),不含会话里的 MCP 工具。
错误按 problem+json 格式返回,参见 错误码
响应
HTTP 200
Matching methods, best match first. An empty `data` array means nothing matched; try fewer or different words.
application/json
| 名称 | 类型 | 说明 |
|---|---|---|
| has_more | boolean | Present without q; true when another page follows. |
| first_id | string | null | Present without q; first method name in this page, or null for an empty page. |
| last_id | string | null | Present without q; last method name in this page, or null for an empty page. Pass as after_id to continue. |
| data | array<object> | Matching methods ordered by relevance for search, or by name for unranked listing. |
| data[].params | string | Compact argument list grouped by location, for example `path: database_id*, table* · query: select, order · body*`. A trailing `*` marks a required argument; `body` stands for the JSON request body. Call `GET /meta/v1/methods/{name}` for each argument's type and description. |
| data[].name | string | Method name such as `praxis.agent.agents.list`. Pass it to `GET /meta/v1/methods/{name}` and call it as `await praxis.agent.agents.list(args)` in codemode or an automation script. |
| data[].summary | string | One-line statement of what the method does. |
| data[].http | string | HTTP verb the method sends, for example GET or POST. |
| data[].path | string | Public API path template the method calls, with `{param}` placeholders filled from `args.path`. |