Omnara: Claude Managed Agents ve OpenAI Agents API İçin Açık Kaynaklı Alternatif

Açık Kaynaklı Yönetilen Ajan Platformu#

Omnara, Claude Managed Agents ve OpenAI'ın Agents API çözümlerine alternatif olarak geliştirilmiş, kendi sunucunuzda barındırabileceğiniz (self-hostable) açık kaynaklı bir yönetilen yapay zeka ajan platformudur. Apache 2.0 lisansı altında ücretsiz olarak kendi altyapınızda çalıştırabileceğiniz veya doğrudan Omnara Cloud üzerinden kullanabileceğiniz bu platform, modern yazılım geliştirme süreçlerinde yapay zeka ajanlarını üretim ortamına taşırken karşılaşılan altyapı zorluklarını ortadan kaldırmayı hedefler.

Geliştiriciler için en büyük avantajı, tek bir sağlayıcıya bağımlı kalmadan herhangi bir modeli ve herhangi bir makineyi API üzerinden yönetebilmesidir. Araç kullanımı (tool calling), gizli anahtar yönetimi (secrets), yetkilendirmeler (permissions) ve anlık veri akışı (streaming) gibi kritik özellikler platformun içinde yerleşik olarak sunulur. Go, Docker ve modern web teknolojileriyle inşa edilen depo yapısı; gözlemlenebilirlik (observability), veritabanı taşıma işlemleri (migrations) ve OpenAPI standartlarını doğrudan destekleyerek kurumsal düzeyde bir mimari sunar.

Hızlı Başlangıç (Quickstart) ve Omnara Cloud#

Platformu deneyimlemek ve öğrenmek oldukça pratiktir. app.omnara.com üzerinden giriş yaptığınızda, ilk projeniz hazır bir model sağlayıcısı (omnara-openrouter) ve yönetilen bir izole çalışma alanı havuzu (default-pool) ile birlikte gelir. Böylece karmaşık altyapı kurulumlarıyla vakit kaybetmeden doğrudan ajan tasarımına odaklanabilirsiniz.

Bir mühendislik asistanı oluşturmak için aşağıdaki yapılandırmayı agent.yaml olarak kaydetmeniz yeterlidir:

• version: v1: Yapılandırma sürümünü tanımlar.
• instruction: Ajana verilen sistem talimatını (örneğin, komut çalıştırmak için makineyi kullanan bir mühendislik asistanı olmasını) belirtir.
• model: Kullanılacak model sağlayıcı yapılandırmasını (omnara-openrouter) ve model adını (anthropic/claude-fable-5.1) içerir.
• machine_sources: Ajanın komutları yürüteceği makine havuzunu (default-pool) tanımlar.

Bu yapılandırmayı Node.js 22 veya daha yeni bir sürümle terminal üzerinden başlatabilirsiniz. npx omnara agents launch komutuna yapılandırma dosyasını, ajan adını ve ilk görev mesajını (örneğin işletim sistemini ve boş disk alanını raporlamasını) vererek ajanı anında ayağa kaldırabilirsiniz. Ardından npx omnara agents chat komutuyla terminalden ajanla sohbet edebilir veya kontrol paneli (dashboard) üzerinden ajanın yaptığı araç çağrılarını (tool calls) canlı olarak izleyip yanıtlayabilirsiniz.

TypeScript SDK ile Kod İçinden Başlatma#

Omnara, sadece komut satırından değil, doğrudan kendi yazılım projelerinizin içinden de programatik olarak yönetilebilir. Öğrenme ve uygulama geliştirme açısından bu özellik, ajanları mevcut mikroservislerinize veya arka uç (backend) sistemlerinize entegre etmenizi sağlar:

• Kontrol panelinden bir API anahtarı oluşturup ortam değişkeni (OMNARA_TOKEN) olarak dışa aktarın.
• Projeye npm install @omnara/sdk komutuyla resmi TypeScript SDK paketini dahil edin ve npx omnara config çıktısındaki organizasyon ile proje kimliklerini (ID) kullanın.
• @omnara/sdk içerisinden createOmnaraClient, bearerToken, openAgentEventStream ve sdk modüllerini içe aktararak kimlik doğrulaması yapılmış bir istemci oluşturun ve agent.yaml dosyanızı okuyarak sdk.createAgentConfig fonksiyonu ile ajan yapılandırmasını kod üzerinden dinamik olarak kaydedip başlatın.

Pratik bir çıkarım olarak; Omnara gibi açık kaynaklı orkestrasyon platformlarını incelemek ve kullanmak, çok adımlı ajanların (multi-step agents) güvenli kum havuzlarında (sandbox) nasıl çalıştırıldığını ve gerçek zamanlı olay akışlarının (event stream) nasıl yönetildiğini anlamak için eşsiz bir öğrenme fırsatıdır.