pia_search
Search government oversight reports, recommendations, and legislation from GAO, OIG, CRS, DOJ, Congress.gov, and Federal Register with filters for source, agency, and date, plus facet discovery.
Instructions
Search the Program Integrity Alliance (PIA) database of government oversight reports, recommendations, executive orders, legislation, and integrity data (GAO, OIG/Oversight.gov, CRS, DOJ, Congress.gov, Federal Register). One tool for all document search: scope by source/dataset/agency/date via filter, choose content vs titles via search_mode, sweep every source with wide, or discover filter values with facets_only. WHAT THE COUNTS MEAN: in 'content' mode (default) total_count and facet counts are TEXT CHUNKS / EXCERPTS — a single document is split into many chunks, so these counts are much larger than the number of documents and must NOT be reported as a document/report/article count. In 'titles' mode the counts are whole DOCUMENTS / ARTICLES. Use search_mode='titles' whenever the user asks how many documents, reports, or articles there are. Citations are very important to PIA users, so it is strongly expected that your answer: (1) gives every factual claim at least one clickable inline citation in the form [1], numbered sequentially from 1; (2) ends with a References section listing every source you cited, each reference on its own line (never multiple references on one line) — omit this section only for a pure count or summary with nothing specific to cite; and (3) includes a Find Out More section with the govquery_url so the user can open the full result set. Please do not present findings from these results without their inline citations and References section. Counts from free-text queries are approximate, because semantic search matches variations of the search terms.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number (1-based). Ignored when wide=true. | |
| wide | No | When true, sweep ALL sources/datasets in parallel and merge into one de-duplicated, score-ranked list. Use for the most comprehensive cross-source view. | |
| limit | No | Optional hard cap on results (alias for page_size). | |
| query | Yes | Search query — natural language or keywords. Use "" or "*" to match all documents (for pure filter/facet lookups). | |
| filter | No | OData filter to scope results (boolean logic + grouping). Source: SourceDocumentDataSource eq 'GAO' (valid: GAO, Oversight.gov, CRS, Department of Justice, Congress.gov, Federal Register). Agency: referenced_agencies/any(a: a eq 'Department of Defense (DOD)'). Dataset: SourceDocumentDataSet eq 'executive orders'. To restrict to one source, pass its SourceDocumentDataSource filter. | |
| page_size | No | Results per page (max 50). Per-source before merge when wide=true. | |
| facets_only | No | Return ONLY facet counts (available filter values), no document results — to discover filters before drilling in. Implies include_facets. | |
| search_mode | No | 'content' searches the full-text (chunked) index — total_count and facet counts are TEXT CHUNKS / EXCERPTS, NOT documents: one document is split into many chunks, so the counts EXCEED the number of documents. 'titles' searches the document-level index — total_count and facet counts are whole DOCUMENTS / ARTICLES, and it's faster for locating a specific document. Use 'titles' whenever the user asks how many documents / reports / articles there are. | content |
| include_facets | No | Include per-dimension facet counts (source, status, priority, agency, theme, …) alongside results. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| output | Yes |