Assess an opportunity
assess_opportunityUse this when the user asks if one opportunity is a good fit for them, whether to bid, or wants a bid brief: days left, set-aside match, similar past awards at the same agency, the firms that usually win such work and the usual award value.
Pass the id from a search result, and optionally my_naics (up to 10 codes) and my_set_aside to check the fit. Similar awards come from MatchAwards' award records for the same NAICS at the same agency, or at all agencies when that agency has none (basis says which); sample gives the dates covered and whether every matching record was read, so state that span rather than a longer one. Award records may be incomplete, so say so; ai text is AI-generated, so label it. Never call a firm the incumbent: these are firms that won similar work. Example: id="117412688283576625".
Print url, sam_url and each award's url and source_url as markdown links.
Do not use for searching (search_contracts, search_grants), for finding partners (find_teaming_partners) or for job postings.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The id field of a search result. | |
| my_naics | No | Up to 10 six-digit NAICS codes, comma-separated, e.g. '236220' or '541511,541512'. A record matches on its own codes (matched_naics says which). Unknown codes are ignored. | |
| my_set_aside | No | The user's set-aside code, e.g. 'SBA' or 'SDVOSBC', to compare with the opportunity's. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ai | No | AI-generated notes on this opportunity, or null. Label them as AI-generated when you show or quote them. | |
| note | No | ||
| as_of | No | ||
| basis | No | 'same NAICS and agency', 'same NAICS, all agencies', or null (no NAICS). | |
| sample | Yes | ||
| warning | No | Set when the award lookup was cut short; the figures cover what was read. | |
| naics_match | No | Whether the opportunity's NAICS is one of my_naics; null when my_naics was not given. | |
| opportunity | Yes | ||
| coverage_note | No | ||
| similar_awards | Yes | The 5 newest similar awards. | |
| set_aside_match | No | Whether the opportunity is set aside for my_set_aside; null when it was not given. An opportunity without a set-aside is open to all firms. | |
| typical_winners | Yes | Up to 5 firms that won similar work, most awards first, then largest total. | |
| award_value_range | No | Quartiles of the similar awards' amounts (USD); null with fewer than 3 amounts. |