agent-gateway
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| kb_list_tagsA | 【常用标签清单】列出知识库当前标签（按文档数倒序）。 【何时用】想按标签检索但不确定有哪些标签时，先调本工具拿 tag_id / name， 再把 name 传给 kb_search.tag_names。【不要】用本工具读正文。 |
| kb_searchA | 【知识检索·万能口】在已编目文档中按关键词/标签/集合/时间/质量筛选。 【硬约束】keyword / tag_names / tag_ids / collection / created_from / created_to / is_digested=true / is_hot=true / has_fulltext 至少传一个，否则报 MISSING_FILTER。 【与 kb_get_doc 的区别】本工具只返回列表与截断摘要，不返回全文。 【参数从哪来】标签名优先来自 kb_list_tags；doc_id 从本工具 items[i].doc_id 取，禁止猜。 【display_mode】compact=80 字 / brief=220 字（默认）/ full=400 字（仍截断）。 【collection】sop / replay / training / talk / internal。 【飞书空洞】completeness=feishu_stub_only 或 has_fulltext=false 表示本地没有全文， 不得当成「文档不存在」。需要正文时再调 kb_get_doc，它会明确拒答。 【何时不用】只要某一篇的章节或正文 → kb_get_outline / kb_get_doc。 |
| kb_get_docA | 【文档正文】按 doc_id 读取单篇正文（分页）。 【参数从哪来】doc_id 必须来自 kb_search.items[i].doc_id，禁止用标题猜。 【分段】默认最多 4000 字；truncated=true 时把 next_offset 原样传入继续读。 【飞书空洞】feishu_stub_only=true 时 readable=false，body 只有导语，不得当成全文。 【何时用】已经拿到 doc_id，用户要看原文/摘要/引用。 |
| kb_get_outlineA | 【第 1 步·文档目录】按 doc_id 返回章节树（标题 + offset + section_id）。 【何时用】长 SOP / 复盘要按章阅读，或准备调用 kb_read_section。 【参数从哪来】doc_id 来自 kb_search。section_id / offset 交给 kb_read_section。 【短文】可能只有一个「全文」节点，此时直接 kb_get_doc 即可。 |
| kb_read_sectionA | 【第 2 步·读某一章】按 section_id 或 outline 返回的 offset 读取一节。 【必须先调 kb_get_outline】section_id 只能取自同一次目录的 sections[i].section_id。 也可把 sections[i].offset 传入 offset。交叉使用别的文档的 section_id 会失败。 |
| biz_list_metricsA | 【指标字典】列出业务层可查询指标、口径、粒度和敏感级。 【何时用】不确定有哪些数、别直接猜表名时先摸地图。 【何时不用】已经明确要查 GMV/退款/花费 → biz_query_sales 或 biz_anomaly_scan。 【禁止】本工具不执行任意 SQL，也不返回底层表结构以外的口径说明。 |
| biz_query_salesA | 【销售查询】按结构化过滤汇总 GMV / 订单 / 退款率。 【硬约束】只能用本工具的过滤字段，禁止拼接 SQL。 【group_by】day / week / sku / category / channel / shop。 【ID 从哪来】sku_id 来自结果或 biz_get_sku；shop_id 为 SHOP-TM / SHOP-DY / SHOP-OS； channel_id 为 tmall / douyin / independent / xiaohongshu。不要编造 SKU。 【金额】gmv_cent 为分，展示时除以 100。 【何时用】「上周哪个 SKU GMV 最高」「音频类目 8 月退款率」。 【何时不用】只要异常对比 → biz_anomaly_scan；只要单订单 → biz_get_order。 |
| biz_get_skuA | 【SKU 详情】按 sku_id 取商品维表。 【参数从哪来】sku_id 必须来自 biz_query_sales / biz_anomaly_scan，禁止猜。 |
| biz_get_orderA | 【订单详情】按 order_id 取一单。intern 角色会被拒绝。 【参数从哪来】order_id 形如 ORD-100123，必须来自查询结果，禁止枚举。 |
| biz_anomaly_scanA | 【异常扫描】对 GMV / 退款率 / 投放转化做环比。 【metric】gmv = SKU 近 14 日 GMV 相对前 14 日；refund_rate = 2026-08 vs 2026-07 类目退款率； ad_cvr = 2026-08-31..09-13 vs 前两周，渠道花费与转化。 【何时用】「有什么异常」「退货率是不是高了」「投放涨了转化没涨」。 【跨层】拿到 category / sku 名后，用 kb_search 找对应 SOP / 复盘，禁止编造内部文档。 |
| catalog_list_assetsA | 【资产目录】列出当前接入的数据/知识资产：格式、行数、敏感级、位置。 【何时用】用户问「现在接了哪些数据」「磁盘上有什么」「有没有订单表」。 【何时不用】要查数走 biz_*，要搜文档走 kb_*。 |
| catalog_lineageA | 【血缘】查看某一资产从源文件到表/文档再到工具的链路。 【参数从哪来】asset_id 必须来自 catalog_list_assets.items[i].asset_id。 【何时用】面试或排障时解释「这份 Excel 怎么变成可查询指标」。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 12 tools
The knowledge base tools (kb_list_tags, kb_search, kb_get_doc, kb_get_outline, kb_read_section) have a clear hierarchical flow (search -> outline -> read), and the business tools (biz_list_metrics, biz_query_sales, biz_get_sku, biz_get_order, biz_anomaly_scan) are distinct operationally. Minor overlap exists between kb_get_doc and kb_read_section, both for reading content, but guidance on when to use each is provided.
Tool names are consistent, following a verb_noun pattern with prefixes indicating domain (kb_, biz_, catalog_). Most use standard verbs like list, get, read, search, query, and anomaly_scan is a slight deviation but still readable.
With 12 tools, the server covers three distinct domains (knowledge, business, catalog) without excessive granularity. The count is reasonable and each tool serves a clear purpose, though it is a bit high for the scope, justifying a slightly lower score.
The server offers a comprehensive read/search surface for knowledge (tag, search, outline, section, full doc) and metrics (dictionary, query, SKU, order, anomaly scan), but lacks write or update tools (no create/edit/delete). This is acceptable if it's a fetch-only gateway, but for general lifecycle coverage it's incomplete.