Ajanlar

Ajanınız işe başlamadan önce bunu ona yapıştırın. Düz markdown'dır, kimlik doğrulama gerekmez ve CORS açıktır; ajan dosyayı kendisi de indirebilir.

Read https://occultapi.com/AGENTS.md before writing any code against Occult API.
Use the OpenAPI spec at https://occultapi.com/openapi.json for exact field names.

Dört kural var. Genel bir stil rehberi değil bunlar: her biri, ajanların burada gerçekten yaptığı bir hatadan çıktı.

• Döngü kurmayın, keys ile tek istekte toplayın. Tek istekte istenen birden fazla hesaplama bir kredi tutar; aynı hesaplamalar ayrı çağrılarla istenirse her biri bir kredi tutar. Okunabilir kodu öne çıkaran bir ajan döngüyü yazar, faturası da bakiyenize çıkar.
• 402 hatasını yeniden denemeyin. Bu kod, anahtarın geçerli ama bakiyenin boş olduğunu gösterir. Bunu geçici bir hata sanan ajan sonsuza dek yeniden dener; kimlik doğrulama hatası sanan ajan ise sorunsuz çalışan bir anahtarı yeniden oluşturur. Yalnızca 429 ve 5xx yeniden denenebilir.
• Anahtar yalnızca sunucu tarafında kullanılır. Bunu açıkça yazıyoruz, çünkü “istemciden çağır” en kolay yoldur ve anahtarınızı herkese açar.
• Alan adlarını tahmin etmeyin, tanımı okuyun. OpenAPI belgesinde her alan, alabileceği değerler ve her endpoint için bir örnek bulunur; örneklerin çoğu canlı sunucuda doğrulanmıştır. Tek bir indirme, üç tane 400 hatasından iyidir.

MCP sunucumuz 299 endpoint'in tamamını beş araçla sunar ve arama yapmak ya da şema okumak kredi harcamaz; kredi yalnızca gerçek bir hesaplamada düşer. Ajan API'nin tamamını ücretsiz keşfeder, yalnızca bir şey hesapladığında harcama yapar. Bu, dokümantasyona bakıp tahmin yürütmesinden hem daha ucuz hem daha güvenilirdir.

Ajanınıza vermeden önce iki dakikanızı ayırmaya değer: /AGENTS.md. Tavsiye yanlışsa bunu fark edecek olan sizsiniz.