Agentic Trader Docs

Veri ve Zekâ Katmanı

Canonical snapshot'lar, feature bundle'lar, provider truth ve kanıt ile reasoning arasındaki sınır.

Veri duruşu

Ham provider payload'ları doğrudan agent truth'u olacak kadar güvenilir değil. Provider'lar anlaşmaz, alanlar eksik gelir, freshness değişir ve tekst özeti önemli boşlukları gizleyebilir.

Repo yönü, dış veriyi model katmanına vermeden önce typed contract'lere normalize etmektir.

Ana sözleşmeler

  • CanonicalAnalysisSnapshot
  • DecisionFeatureBundle
  • MarketContextPack
  • canonical birleşim öncesi provider'a özgü fundamental ya da news snapshot'ları

Bunun önemi

Modelden belirsiz string'lerden örtük finansal gerçek çıkarması beklenmemeli. Model şu girdileri almalı:

  • yapılandırılmış özetler
  • missing-field visibility
  • freshness context
  • source attribution
  • açık risk flag'leri

Provider aggregation kuralları

Bu repo için iyi aggregation şu anlama gelir:

  • provider'a özgü string parsing yerine canonical output'u tercih etmek
  • eksik provider evidence'ı görünür tutmak
  • source attribution'ları korumak
  • evidence katmanı zayıfsa confidence'ı düşürmek
  • generic fallback'leri açıkça fallback diye etiketlemek

Feature preparation

Feature katmanı; karışık market, provider ve runtime sinyallerini derli toplu bir decision context'e dönüştüren yerdir. Bu katman eksik ya da yarımsa downstream confidence bunu yansıtmalıdır.

Bu yüzden missing context ya da missing decision_features, kozmetik bir eksik değil gerçek bir provider ya da evidence gap olarak ele alınmalıdır.

Haber ve dünya-durumu kanıtı

Haberler, filing'ler, makro açıklamalar, browser fetch'leri ve arama sonuçları ancak küçük evidence packet'lerine dönüştükten sonra faydalıdır. Kullanılabilir bir packet; kaynağı, yayın zamanı, fetch zamanı, fresh/stale durumu, hangi fetcher yolunun kullanıldığını, source tier'ı ve neden material olduğunu göstermelidir.

Agentic Trader ham makale metnini ya da sosyal medya postlarını trading prompt'larına vermemelidir. Güvenli yol şudur: topla, redakte et, özetle, sınıflandır, kaynak göster, sonra scanner ve proposal review yüzeyleri kompakt sonucu kullansın.

Bu sözleşmenin ilk operator-facing runtime yüzeyi şudur:

agentic-trader news-intelligence --symbol AAPL --company-name Apple --sector "consumer technology" --json

Bu komut web'i kendisi scrape etmez. Query template'leri, source tier'ları, freshness kurallarını, gürültülü domain exclude listesini, material event tiplerini ve ham makale metnini core trading prompt'una sokmayan prompt politikasını üretir.

Strateji zekâsı

V1 strateji yolu bilinçli olarak muhafazakârdır. Momentum, gap review, mean-reversion, breakout/reclaim ve volatility preset'leri; provider evidence, liquidity/spread kontrolleri, sizing varsayımları ve proposal review ile zenginleşene kadar research helper olarak kalır.

Bu profiller artık runtime metadata olarak görülebilir:

agentic-trader strategy-catalog --json
agentic-trader strategy-profile vwap-breakout --json
agentic-trader idea-score --symbol AAPL --preset momentum --price 190 --volume 5000000 --change-pct 6.2 --relative-volume 3.4 --json
agentic-trader proposal-candidate-create --symbol AAPL --preset momentum --price 190 --volume 5000000 --change-pct 6.2 --relative-volume 3.4 --quantity 1 --stop-loss 182 --take-profit 205 --json
agentic-trader proposal-candidate-promote CANDIDATE_ID --json

Çıktı; gerekli girdileri, eksik evidence'ı, risk kontrollerini, validation check'leri ve scanner sonucunun neden pending proposal'a dönüşmeden önce hâlâ broker-free candidate review istediğini anlatır.

Opening-range, VWAP, Keltner/Bollinger, regime-adaptive, pairs ya da ensemble gibi daha ileri fikirler önce no-lookahead kontrolleri, backtest confidence review ve açık invalidation kurallarından geçmelidir. Bunlar geçse bile emir değil, proposal candidate veya promotion sonrası pending proposal üretir.

Finans/muhasebe kanıtı

finance-ops --json artık trades, cash, fees/taxes, dividends, interest ve corporate actions gibi ledger kategorileri için bir reconciliation contract taşır. V1 paper mod bazı kategorileri dürüstçe missing gösterebilir; önemli kural, missing evidence'ın asla sıfır evidence gibi davranmamasıdır.

Sürekli araştırma döngüsü

Benchmark loop fikri runtime'da read-only contract olarak görülebilir:

agentic-trader research-cycle-plan --symbols AAPL,MSFT --json

Fazlar PRE-FLIGHT, MONITOR, ANALYZE, PROPOSE ve DIGEST'tir. Plan her fazın hangi mevcut komutlardan okuduğunu gösterir ve sert güvenlik çizgisini tekrar eder: döngü fikirleri ve pending proposal'ları yüzeye çıkarabilir, fakat approve edemez, emir gönderemez, policy değiştiremez ya da eksik source evidence'ı gizleyemez.

Review ve persistence bağlantısı

Bu yapısal artefact'ler yalnızca canlı reasoning için değil şunlar için de önemlidir:

  • review yüzeyleri
  • QA
  • replay
  • provider ile agent arasındaki anlaşmazlıkları debug etmek

Güvenli zihinsel model

Modeli, typed evidence üzerine oturan bir reasoning katmanı olarak düşün. Eksik piyasa gerçeğini icat eden yer olarak değil.

Bu sayfa nasıl?
Bu GitHub Pages build'i tarayıcı içinde yerel bir feedback taslağı ve hazır doldurulmuş GitHub issue bağlantısı üretir. Node-hosted local docs ileride runtime loglarına bağlanabilir.

Taslağı bu tarayıcıda tutar ve hazır olduğunda gönderebilmen için GitHub issue bağlantısı verir.

On this page