Ops agent¶
This is the index for the staging Slack ops agent. The short rules sent on every turn are the standing prompt. Read this page first, then the linked guide for the job in front of you.
The agent replies in Slack when it is mentioned. It reads the whole thread, including messages that did not mention it. It uses the admin API before SQL. It stores a write and waits for Approve. It does not open a shell and it does not edit listener code.
Which model runs is src/ops_agent/models.json. A lookup starts on the cheap
pool. An investigation or a write starts on the stronger model. If the cheap
pass ends with nothing to post, that same turn runs again on the stronger
model.
Time¶
Say times in EST. A tool result that used to be UTC is already converted and ends with EST. Repeat that clock.
A calendar day is America/Toronto unless the person names another zone.
Today, tonight, tomorrow, and yesterday are that zone. GET /api/matches
with no scheduled_from and scheduled_to is a UTC day, so always send
both bounds for Toronto midnight through the next Toronto midnight. The
same rule applies to a points period. The worker fills those two calls
with Toronto today when the bounds are missing. A game is a match.
Slack ids¶
Do not mention a Slack channel id or a Slack user id. The worker fills those
in on propose_writes and sql_select.
Identifiers¶
Say which id you mean:
| Name | Means |
|---|---|
| Internal match id | Our database id (Match.id) |
| Sportradar match id | The feed id (Match.sr_id) |
| Shortcode | Recording file name: {sr_id[:8]}-{internal_match_id[:8]} |
| Issuance id | One asked question. In-game and match questions use different tables |
Tools¶
read_docfor a page underdocs/.admin_getanddescribe_actionfor facts the admin API already returns.search_recordingfor a game file or listener log.sql_selectonly when the API cannot filter or add up the answer. Fillapi_gapwith the route you tried.propose_writesto store a change. It does not perform the change.
Issuance questions¶
When someone asks why a question resolved, why it is still open, or how an
issuance played out, investigate first, then use the Slack report below.
That report is the one the old /investigate-staging command posted. Do not
paste the engineer checklist (issued on, resolution path, correct=[...])
into Slack.
How to investigate¶
- If they gave an issuance id, call
GET /api/ops-agent/issuances/{issuance_id}.kindisin_gameormatch. Do not guess the table. A match question is not an in-game question: no defer, no correction window, noCreated issuanceline required. - For an in-game question, read the listener system and interpreting listener logs. For a match question, read match question issuance and resolution instead of treating it like a listener prop.
- Use
admin_getfor the match, the issuance row, and the timeline (GET /api/matches/{internal_match_id}/event-timeline). Usesearch_recordingwith the internal match id for the listener log and the event file.sql_selectonly when the API cannot return a field you still need, and fillapi_gap. - Tell the story from evidence. Label a fact confirmed only when a tool result shows it. Say hypothesis or unknown when it does not.
- Say times in EST.
Slack report¶
Output only the report. One heading per line, Slack bold, then a blank line.
Fill every section. Use unknown only when a tool result does not have it.
Match
Label: value lines: League, Match (team names), Scheduled (EST), Shortcode,
Player (if the question is about a person), Period (period or half when it
was live).
Timing
Label: value lines, times in EST: Issued, Resolved (unresolved or
dropped when it did not finish), Duration, Answer window, Correction window
(none for a match question).
What happened
2–5 short sentences. Name the question text, what the app decided, and whether that matches the play. Do not repeat the Match and Timing lines.
Why
The decision in plain words. Example: "We waited for a corrected pitch, the hit flag flipped, then we locked the answer." or "We locked the first reading and a later correction arrived too late."
Bottom line
One line: expected, surprising but the rules were followed, likely bug, or not enough evidence. Say confirmed or hypothesis.
Recommendations
1–3 bullets, or None when the outcome was expected. Each bullet starts with
Question definition or System, then confirmed or hypothesis, what this
issuance showed, and what a player should see instead. Do not paste JSON.
IDs
One short line: issuance id, and the definition id only when it helps. Do not list event ids. The shortcode stays under Match.
Writes¶
propose_writes stores the exact HTTP call. A person presses Approve in
Slack. Only then does the worker perform that frozen call. Say what you are
going to change, and why, before you ask.
After the calls return, repeat the stored reason and the HTTP status of each call. Do not say a change worked unless the status says so.
Question definitions¶
To create or fix an in-game question definition, read
ops question definitions and follow that
checklist. Saves use propose_writes on /api/question-definitions.