ai-hedge-fund özel API kurulumu

Güncel uygulama yolunu belirleyin

Güncel ai-hedge-fund uygulamasında OPENAI_API_BASE ayarlamadan önce modelin kayıt defteri sağlayıcısını doğrulayın. fc1bf250 revizyonunda istemci fabrikası hedge_fund/llm/client.py içinde yaşar ve yanındaki kayıt defterini okur. Yalnızca src/llm/models.py'ye başvuran eski öğreticiler farklı bir uygulama yolunu anlatır. Checkout'u sabitleyin ve güncel fabrikayı içe aktaran giriş noktasını kullanın. Aşağıdaki sağlayıcı ön kontrolüyle başlayın, sonra eksiksiz araştırma döngüsü için finansal veri toplamadan önce proje istemcisini çalıştırın.

Temel URL'yi ayarlamadan önce sağlayıcıyı çözümleyin

make_llm, seçilen model tanımlayıcısından bir sağlayıcı seçer. OpenAI dalı OPENAI_API_BASE değerini ChatOpenAI'ye iletir ve ilgili API anahtarını okur. İncelenen kaynakta bilinmeyen bir tanımlayıcı Anthropic taşımasına geri düşer; bu nedenle yalnızca bir OpenAI temel URL'si dışa aktarmak yeterli değildir. Önce kesin uç nokta model ID'sinin OpenAI altında kayıtlı olduğunu doğrulayın. Burada OpenAI taşıma bağdaştırıcısını tanımlar; alttaki model satıcısını onaylamaz. Her iş akışının tükettiği tüm kayıtları anlamadan küresel kayıt girdisini değiştirmeyin.

İstek yapmadan yapılandırmayı inceleyin

Aşağıdaki örnek, yerel kayıt defteri farklı bir taşıma seçerse istemci kurulmadan önce başarısız olur. RESEARCH_MODEL_ID'yi uygulama kaydını incelediğiniz güncel bir katalog ID'sine ayarlayın. Yoksa mevcut display_name, model_name ve provider alanlarını koruyarak yerel kayıt defterine bilinçli biçimde bir satır ekleyin; ilgisiz girdileri değiştirmeyin. Yer tutucu desteklenen model iddiası değildir. Anahtarı ortam veya gizli bilgi deposu üzerinden sağlayın. Bu ön kontrol yalnızca seçimi kontrol eder; ağ erişimini, hesap yetkisini, yapılandırılmış çıktıyı veya araştırma kalitesini kanıtlayamaz.

import os
from hedge_fund.llm.registry import provider_for

model = os.environ["RESEARCH_MODEL_ID"]
if provider_for(model) != "OpenAI":
    raise RuntimeError("MODEL_TRANSPORT_MISMATCH")
os.environ["HEDGE_FUND_LLM_MODEL"] = model
os.environ["OPENAI_API_BASE"] = "https://api.apisrouter.com/v1"
assert os.environ["OPENAI_API_KEY"]
# Selection check only; no make_llm() or model request.

Önerilen model yolunu izleyin

Model yolu kayıt defteri çözümlemesinden sonra başlar. Uygulamanın yine de finansal veri istemcisine, evren tanımına ve açık bir araştırma tarihine ihtiyacı vardır. Ağ geçidi anahtarı Financial Datasets kimlik bilgisi veya piyasa verisini yeniden dağıtma hakkı değildir. Şirket tanımlayıcılarını, para birimini ve zaman damgası anlamını bağımsız doğrulayın. Çapraz listelenmiş şirketlerde analizinizin ihraççıyı mı, yerel pay sınıfını mı yoksa depo makbuzunu mu kapsadığını belirtin. Finansal serinin eksikliği LLM sorunu sanılmasın diye model istek kanıtını sağlayıcı verisi kanıtından ayrı tutun.

Ayrıştırılmış kararları veri olarak doğrulayın

İncelenen fabrika, sağlayıcı istemcilerini eksiksiz(system, user) yöntemi arkasına sarar. Yanıt metni otomatik olarak geçerli araştırma sonucu değildir. JSON'u ayrıştıran, çekimserliği işleyen ve çıktıları birleştiren ajan katmanını inceleyin. Yanıt boş olmayabilir fakat biçimi bozuk, kendi içinde çelişkili veya girdilerle desteklenmemiş olabilir. Ham redakte edilmiş yanıtı ve ayrıştırılmış nesneyi tek bir istek kaydı altında saklayın. Güven verici bir cümleyle eşleşmek yerine beklenen alanları ve izin verilen durumları doğrulayın. Eksik veya reddedilmiş sonucu portföy toplamına sessizce giren nötr sinyal değil, kullanılamıyor sayın.

import os
from hedge_fund.llm.client import make_llm, extract_json
from hedge_fund.llm.registry import provider_for

model = os.environ["HEDGE_FUND_LLM_MODEL"]
assert provider_for(model) == "OpenAI"
client = make_llm(model=model)
result = extract_json(client.complete(
    "Return a JSON object with a boolean ready field.",
    "Set ready to true.",
))
assert result.get("ready") is True
# This request tests the client and parser, not financial research.

İlk araştırma döngüsünü küçük ve incelenebilir yapın

Yetkili istemci testinden sonra lisanslı veya herkese açık kanıtla tek bir ihraççı ve sınırlı bir soru seçin. Her gerekli aracın beklenen şirketi ve dönemi döndürdüğünü doğrulayın, ardından üretilen açıklamayı özgün belgelerle karşılaştırın. İlk koşuyu salt okunur tutun ve açık bir insan inceleme adımı saklayın. Çıktının destekleyici ve karşıt kanıtı alıntılayıp alıntılamadığını, eksik veriyi kaydedip kaydetmediğini, varsayımları hesaplamalardan ayırıp ayırmadığını değerlendirin. Analist rolünün adı veya yatırım stili, üretilen akıl yürütmenin gerçek kişinin yöntemini ya da yargısını yeniden ürettiğinin kanıtı değildir.

Geriye dönük test kanıtını bağımsız tutun

Bir uygulama araştırma döngüsünü tamamlayabilir, fakat tarihsel değerlendirmesi geçersiz kalabilir. Yayım zaman damgalarını, düzeltilmiş veriyi, hayatta kalan şirket seçimini ve tarihsel istemlerde güncel haber kullanımını inceleyin. İstemleri veya strateji ayarlarını yinelemeden önce geliştirme, doğrulama ve ayrılmış dönemleri ayırın. Karşılaştırma ölçütünü, işlem maliyeti varsayımlarını ve denenmiş her yapılandırmayı saklayın. Aynı test dönemine göre tekrar tekrar istem seçmek bu dönemi geliştirme verisine dönüştürür. Örnek bir getiriyi ölçüm sanabilecek sonuç tablosunu doldurmak yerine eksik değerlendirmeyi dürüstçe raporlayın.

Arızaları ve toplam araştırma harcamasını kontrol edin

Model çağrılarını, yeniden denemeleri, ayrıştırma hatalarını, finansal veri ücretlerini ve yerel hesaplamayı iş düzeyinde sayın. Bir uç nokta zaman aşımı, kullanım uzlaştırılana kadar faturalandırmayı bilinmeyen bırakabilir. Geçici taşıma hatalarını sabit bütçe içinde yeniden deneyin; kimlik doğrulama veya sağlayıcı seçimi hatalarını sebebi değiştirmeden yinelemeyin. Başarısız aşamayı ve temizlenmiş hatasını inceleme için erişilebilir tutun. Genel bir ağ geçidi hello yanıtı taşımayı izole etmeye yardım edebilir, ancak bağdaştırıcı davranışını yalnızca projenin kendi istemci testleri sınar. Yararlı maliyet karşılaştırması model adayları arasında kaynak paketini, rolleri ve çıktı kabul ölçütlerini sabit tutar.

Kanıt ve sınırlamalar

Güncel fabrika ve kayıt defteri 5 Eylül 2026'da fc1bf250 revizyonunda incelendi. Örnekler kaynak destekli şablonlardır; bu kılavuz için APIsRouter isteği veya eksiksiz araştırma döngüsü çalıştırılmadı. Başka ağ geçitleri üzerinden önceki çağrılar bu entegrasyonu kanıtlamaz. Ortamınızı doğrularken istemci, veri aracı ve eksiksiz varlık sonuçlarını ayrı tutun.

Sık sorulan sorular