AI stock watchlist research agent

Meaningful update کی تعریف کریں

Watchlist agent کو بتانا چاہیے کہ last reviewed research packet کے بعد کیا بدلا۔ Relevant events define کریں: نئی filing، corrected disclosure، earnings call یا open research question کو متاثر کرنے والی evidence۔ ہر issuer کے research questions اور source coverage کو identifier کے ساتھ store کریں۔ اس سے model کو bounded job اور reviewer کو notification کی وجہ ملتی ہے۔ صرف timer fire ہونے پر unrestricted company analysis schedule نہ کریں؛ unchanged inputs عموماً unchanged state دیں، ایک اور long report نہیں۔

Collection کو research generation سے الگ کریں

پہلے source feeds یا permitted polling سے metadata collect کریں، پھر فیصلہ کریں نئی material model work warrant کرتی ہے یا نہیں۔ SEC developer resources US-filer collection کے لیے filing feeds اور indexes بتاتے ہیں؛ دوسرے markets کے اپنے authoritative sources چاہییں۔ Publication time، retrieval time اور source revision الگ store کریں۔ Changed webpage wrapper نئی company disclosure نہیں۔ Relevant document یا event سے content identity بنائیں اور source errors کو nothing-changed determination سے الگ رکھیں۔

Market اور source کے مطابق schedule کریں، ایک global clock سے نہیں

ہر security کے ساتھ exchange timezone اور holiday calendar رکھیں۔ Information availability کے لیے disclosure timestamps اور summary کا وقت طے کرنے کے لیے الگ schedule استعمال کریں۔ Issuer market hours کے باہر publish یا کئی markets میں list ہو سکتی ہے۔ ہر event کو ایک calendar date پر shift کر کے ordering نہ کھوئیں۔ Recurring jobs میں intended window اور actual execution time record کریں۔ Missed run last completed collection watermark سے resume ہو، interval خاموشی سے skip یا پوری history replay نہ کرے۔

Explicit job اور notification states استعمال کریں

چھوٹی state machine recurring work operate کرنا آسان بناتی ہے۔ unchanged، new evidence، source unavailable، research pending اور review required الگ رکھیں۔ نیچے illustrative record application design ہے، scheduler product configuration نہیں۔ Stable event key اور source-manifest hash رکھیں تاکہ same job retry duplicate work یا notifications نہ بنائے۔ Event complete mark کرنے سے پہلے artifact persist کریں۔ Notification delivery کی اپنی acknowledgment state ہو؛ successful report generation سے اسے infer نہ کریں۔

{
  "issuer_id": "REQUIRED",
  "event_key": "REQUIRED_STABLE_KEY",
  "source_manifest_hash": "REQUIRED",
  "collection_status": "pending",
  "research_status": "not_started",
  "review_status": "pending",
  "notification_status": "not_sent"
}

Current اور prior packet سے change note بنائیں

Model کو new source، previous reviewed note اور open questions دیں۔ Source locators اور کس prior statement کو update کرنا ہے، واضح short change log مانگیں۔ Original note کو revision کے طور پر رکھیں، overwrite نہ کریں۔ New disclosure interpretation کو strengthen، weaken یا unchanged چھوڑ سکتی ہے؛ ہر event کو directional stock signal نہ بنائیں۔ Previous packet missing ہو تو historical comparison invent کرنے کے بجائے initial research state بنائیں۔

Recurring budget اور retry policy bound کریں

Scheduling سے پہلے issuers، source volume، model attempts اور wall-clock work کی per-run limits set کریں۔ Planning میں current model contract اور event اور job کے حساب سے actual usage رکھیں۔ Source retries کو model retries سے الگ کریں تاکہ temporary filing outage stale data کا repeated analysis نہ چلائے۔ Document اور parser versions سے extraction cache کریں۔ Budget ختم ہو تو نئی work stop کریں، queued events محفوظ رکھیں اور unresolved state دکھائیں۔ Notification frequency کو collection frequency سے الگ رکھیں تاکہ review load غیر ضروری نہ بڑھے۔

چھوٹی operational miniflow exercise کریں

Recurring delivery enable کرنے سے پہلے unchanged document، new revision، temporarily unavailable source اور retried notification test کریں۔ Stable event identity، درست research status اور same completed event کے لیے exactly one intended notification verify کریں۔ پھر ایک complete change note کو original evidence کے خلاف inspect کریں۔ Collector اور research tools read-only رکھیں، external messaging destinations کے لیے explicit authorization استعمال کریں۔ Research approval order approval نہیں؛ unattended watchlist کو broker permissions نہیں ملنی چاہییں۔

Evidence اور limitations

یہ guide official filing resources اور source-reviewed research applications سے informed workflow design ہے۔ اس page کے لیے recurring watchlist job، notification delivery یا measured usage case execute نہیں ہوا۔ Operational claim سے پہلے deployment record actual scheduler، source coverage، model، persisted event states اور notification test identify کرے۔

عمومی سوالات