Summarize NIAID Data Search Results
niaid_data_summarizeSummarize NIAID Data search results without loading all records. Returns total count, field breakdowns, sample hits, and refinement tips to help narrow queries before fetching full data.
Instructions
Summarize a NIAID Data search without returning all records to the context.
Use this tool BEFORE niaid_data_query when a search may return many results, or when you need to understand what's available before fetching full records. Returns a compact overview: total count, distribution breakdowns across key fields, a small sample of top hits, and specific suggestions for narrowing the search.
This is the right tool when:
You don't know how many results a query will return
The user asks "what's available about X" or "give me an overview of X"
A previous niaid_data_query returned 1000+ hits
You need to help the user decide how to filter or focus their search
Args: params (SummarizeInput): Validated input parameters containing: - q (str): Elasticsearch query string (same syntax as niaid_data_query). Use '' to summarize the entire catalog. Default: ''. - sample_size (Optional[int]): Top-scoring records to show as examples (1–20). Does NOT return all results. Default: 5.
Returns: str: Markdown summary containing:
**Overview**
- Total matching records and query time
**Distribution** (fields with data only)
- Resource type breakdown (Dataset, ComputationalTool, ResourceCatalog, …)
- Access conditions (Open, Restricted, Closed)
- Health conditions, infectious agents, species, measurement techniques,
topic categories, funders — wherever data exists for this query
**Sample records** (top `sample_size` hits by relevance)
- Name, type, ID, and description snippet for each
**Refinement suggestions**
Generated from the actual distribution data:
- Concrete filter additions (e.g., `AND @type:Dataset`)
- Field-specific search tips
- Pagination guidance if proceeding with niaid_data_queryExamples: - Use when: "What COVID-19 resources are available?" -> params with q='COVID-19' - Use when: A query just returned 48,000 results -> params with q= to understand how to narrow it - Use when: "Give me an overview of malaria datasets" -> params with q='malaria' - Don't use when: You need specific records (use niaid_data_query instead) - Don't use when: You have a specific ID (use niaid_data_get instead)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes | Input model for summarizing a potentially large set of NIAID Data results. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |