Skip to main content
Glama

tenders

unit_report

機關情報報告:發包規模與金額、主要供應商、供應商集中度、 競爭程度(平均投標家數/單一投標率/流標率)、發案旺月,以及 「固定週期標案」——每年重複招標的案與預估下次發案時間。 unit 可以是機關代碼(如 3.76.54)或機關全名(會自動查代碼)。 適合回答「這個機關好不好投」「它什麼時候會再發案」。

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
unitYes

TDQS

A4.2/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

無任何 annotations,描述必須承擔行為說明責任。描述說明了 unit 可接受代碼或全名且會自動查代碼,但未揭露是否為唯讀操作、回傳格式、資料時效或潛在限制。以報告型工具而言,這些資訊對 AI 正確使用有幫助,但描述僅部分提供。

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

描述精煉且結構良好,先列報告內容,再解釋參數格式,最後提供適用情境。沒有冗餘詞句,每一句都有資訊價值,且重點資訊置於前段。

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

對於單一參數且無輸出 schema 的工具,描述已提供呼叫所需的足夠資訊:參數格式、報告內容、適用問題。但未說明回傳資料的呈現方式(如文字或結構化),也無提及錯誤情境或需注意事項,故在完整性上仍有小幅缺口。

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema 僅有 unit 的型別與欄位名,描述明顯補足了語意:說明 unit 可以是機關代碼或全名,並舉例(如 3.76.54)。因為 schema 覆蓋率 0%,描述成功補償參數意義,僅未給出完整格式規範,故給 4 分。

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

描述清楚指出工具的用途是產生機關情報報告,並具體列出報告涵蓋的資料類別(發包規模、供應商、競爭程度、發案旺月、固定週期標案等),與其他兄弟工具如 vendor_report、search_tenders 明顯區隔。參數 unit 的用法也有說明。

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

描述明確指出「適合回答『這個機關好不好投』『它什麼時候會再發案』」,提供了清楚的使用情境,讓 AI 能判斷何時選用此工具。但未提及何時不該使用或明確的替代工具名稱,因此未達 5 分。

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

A4.1/5.0
Disambiguation5/5

Each tool has a clearly distinct purpose: search, entity lookup, tender detail, price analysis, vendor/unit reports, head-to-head comparison, and hot opportunities. Even similar-sounding vendor_report and compare_vendors are unambiguously different in scope.

Naming Consistency3/5

Naming is mixed: some tools use verb_noun (search_tenders, find_entity, get_tender, compare_vendors) while others use noun_noun or adjective_noun (unit_report, vendor_report, price_analysis, hot_opportunities). The style is readable and snake_case is consistent, but there is no single predictable pattern across the set.

Tool Count5/5

Eight tools is a well-scoped size for a government tenders intelligence server. Each tool covers a meaningful workflow area without redundancy or bloat.

Completeness5/5

The tool surface covers the full read-only intelligence workflow: searching tenders, resolving entities, retrieving a tender's complete lifecycle, analyzing pricing, surfacing opportunities, and generating counterparty/unit/vendor reports. No obvious dead ends or major missing operations for the stated domain.

Resources