Stock brief
Give a tight, decision-useful read on one ticker from AlphaAI's enriched feed. Not a price quote — a news brief: what's been happening, what the last earnings filing actually said, who's buying or selling, and what to keep an eye on.
Steps
- Resolve the ticker. If the user gave a company name, not a symbol, call
alphai_tickers(q=...)to find it. Ifalphai_ticker_newsreturnsunknown_ticker=true, tell the user and stop — don't invent coverage. - Pull the ticker feed. Call
alphai_ticker_news(ticker, collapse_stories=true).collapse_storiesfolds syndicated reprints into one row each and adds asources_countcorroboration signal — prefer it for a clean brief. Insider news is included by default; keep it. - Earnings read. Call
alphai_earnings(ticker)for AlphaAI's own filing-verified reads (8-K item 2.02 / 6-K earnings release, every figure checked against the filing). The feed tools return articles about a quarter; this returns the filing's numbers. An emptyreportslist is a normal answer, not an error. If non-empty, lead from the newest read —fiscal_period,verdict(strong/solid/mixed/weak), a headlineanalysis.key_metrics, guidance;next_report_dateis company-confirmed (never an estimate) andnullmeans none held. - Optional context. If the user wants the wider tape, call
alphai_trending(limit=5)and note any market-level story that touches this name or its sector. - Deep-dive on demand. If one story clearly drives the brief and the user
wants detail, fetch it with
alphai_article(uid)for the full enrichment (ticker analysis, key entities). The article body is not served — work from the enrichment and summary.
Output
Keep it to a screen. Structure:
- One-line read — the single most important thing about this name right now.
- Top stories — 3–5 bullets, each: headline · relevance score · one-clause
"why it matters". Lead with the highest
relevance_score. - Earnings — the newest
alphai_earningsread if there is one: period · verdict · 1–2 metrics · guidance line. Otherwise one line ("no published AlphaAI earnings read yet"). - Insider activity — any Form 4 / 13F rows from the feed: who, buy or sell, size if given. "No notable insider activity in the window" is a valid line.
- Watch next — 1–2 concrete things that would change the picture, incl. the
next_report_datewhen set.
Guardrails
- Every story carries a 1–10
relevance_score; lead with the high ones and say the score so the user can calibrate. - This is news, not advice. Don't issue buy/sell calls or price targets — summarize what the reporting says and let the user decide.
- If the feed is thin, say so plainly rather than padding. A short honest brief beats a long speculative one.