Model seçiminden sonuç teslimine kadar ajanınıza bir OmniaKey iş akışı verin.
01
Aracınızı kurun
Skill dosyasını mevcut projeye kurup ajanınızı seçin ve yeniden yükleyin. MCP bağlantısını da kurun veya CLI yükleyin; Skill yönergeler sağlar.
npx skills add omniakey-com/omniakey-devtools --skill omniakey-models02
API anahtarınızı bağlayın
Anahtarı terminaldeki gizli girişe yapıştırıp Enter tuşuna basın. Ajanı bu ortamdan başlatın; anahtarı isteme veya depoya yazmayın.
API anahtarı alınread -s OMNIAKEY_API_KEY
export OMNIAKEY_API_KEY$env:OMNIAKEY_API_KEY = [System.Net.NetworkCredential]::new('', (Read-Host 'OmniaKey API key' -AsSecureString)).Password03
Üretim yapmadan doğrulayın
Ajandan omniakey-models dosyasını yükleyip kontrolü çalıştırmasını isteyin. Skill kurulumu tek başına anahtar veya çalıştırma aracı yapılandırmaz.
OmniaKey MCP veya CLI bağlantısının hazır olduğunu doğrula. Erişilebilir modelleri listele ve ortak medya isteği şemasını oku. Üretim görevi gönderme.Modelinizi bulun
API anahtarınızın erişebildiği modelleri sorgulayın, ardından belgelenen özelliklerini ve güncel fiyatlarını kontrol edin.
Bir istek gönderin
Metin ve asenkron görsel, video veya ses görevleri için aynı OmniaKey API'sini kullanın.
Kaldığınız yerden sürdürün
Görev id değerini saklayın ve sorgulamaya devam edin. Yerel zaman aşımı ikinci bir üretim başlatmaz.
Girdiden sonuca bir görev
CLI kurulduktan sonra örneği image.json olarak kaydedin. Ücretli istekten önce modeli ve fiyatı kontrol edin. TASK_ID yerine dönen id değerini yazın.
omniakey submit --file image.json --idempotency-key YOUR_UNIQUE_TASK_KEY
omniakey task wait TASK_ID --timeout 300
omniakey task get TASK_ID04
Skill ne öğretir
Agent Skill bir talimat kümesidir, çalışma ortamı değildir. Ajana yinelenebilir bir akış verir; çağrıları MCP sunucusu veya CLI yapar.
Seçmeden önce modelleri keşfet
Hatırlanan bir ada güvenmek yerine geçerli API anahtarı için kullanılabilir modelleri sorgula.
Modelin belgesini oku
İstek oluşturmadan önce model sayfasında desteklenen girdileri ve güncel fiyatları kontrol et.
Idempotency anahtarı kullan
Amaçlanan her üretim için kararlı bir anahtar tut ki kaybolan yanıt çift ücrete dönüşmesin.
Görevleri yeniden başlatma, devam ettir
Dönen id'yi sakla ve sorgula. Yerel zaman aşımı yeni gönderimi asla haklı çıkarmaz.
Sonuçları doğru bildir
Kuyruktaki görevi bitmiş görevden ayır ve başarısız veya iptal edilen görevi belirt.
Kimlik bilgilerini dikkatle işle
Anahtarı ortamdan oku ve promptların, günlüklerin ve depo dosyalarının dışında tut.
05
Kurulum seçenekleri
Kurucu Skill'i varsayılan olarak geçerli projeye yazar. Kullandığınız ajanı seçin veya projeler arasında paylaşmak için global kurun.
npx skills add omniakey-com/omniakey-devtools --skill omniakey-models --agent codexnpx skills add omniakey-com/omniakey-devtools --skill omniakey-models --agent claude-codenpx skills add omniakey-com/omniakey-devtools --skill omniakey-models --global06
Görev durumları
Skill eyleme geçmeden önce durumu kontrol eder. Karşılaşabileceği durumlar şunlardır.
| Durum | Anlam | Sonraki adım |
|---|---|---|
| queued | Kabul edildi ve bir çalışan bekliyor. | Bekleyin veya aynı id'yi sorgulayın. |
| processing | Çalışıyor; sonuç henüz hazır değil. | Sorgulamaya devam edin; yeniden göndermeyin. |
| succeeded | Varlıklarla tamamlandı. | İmzalı URL'leri süresi dolmadan kullanın. |
| failed | Sonuç olmadan tamamlandı; ayrılan kredi geri verilir. | Hatayı okuyun, isteği düzeltin ve yeni görev gönderin. |
| canceled | İptal tamamlandı. | Yeni görevi yalnızca çıktı hâlâ gerekiyorsa gönderin. |
07
MCP veya CLI ile çalışır
Skill akışı sağlar; API'yi kendisi çağırmaz. Ajanın yürütme yolu olması için OmniaKey MCP sunucusunu bağlayın veya CLI'yi kurun. Tek başına kurulum anahtar yapılandırmaz.
08
Bu araç hakkında
Sabitlenmiş sürüm v0.1.0
OmniaKey geliştirici araçları açık kaynaktır ve etiketli bir GitHub paketi olarak yayımlanır. Bu sayfa o sürümün komut yüzeyini ve davranışını belgeler.
- Lisans
- MIT
- Mimari
- CLI veya MCP istemcisi → paylaşılan istemci → api.omniakey.com/v1
- Testler
- Depodaki entegrasyon testleri CLI'yi yerel bir HTTP sunucusuna karşı, MCP sunucusunu ise gerçek bir stdio istemcisiyle çalıştırır. Ücretli üretim çalıştırmazlar.
- Anahtar işleme
- Bu site API anahtarınızı hiçbir zaman almaz. CLI ve MCP sunucusu anahtarı ortamdan okur ve yalnızca API uç noktasına gönderir.
Sık sorulan sorular
Model fiyatları değişir mi?
Hayır. Araçlar mevcut API anahtarınızı ve API'nin faturalandırma kurallarını kullanır. Model listeleme ve yerel şema kontrolleri üretim başlatmaz; metin ve medya üretimi ücretli olabilir.
Bekleme süresi dolarsa ne olur?
Uzak görev iptal edilmez veya yeniden gönderilmez. id değerini saklayıp task get veya task wait ile devam edin. Dosya bağlantıları sona erdiğinde yeni bağlantı için aynı görevi sorgulayın.
Agent Skill barındırılan bir hizmet mi?
Hayır. Projenize veya ajan ortamınıza kurulan bir talimat klasörüdür. OmniaKey tarafından barındırılan bir Skill uç noktası yoktur.
Skill'i kurmak API anahtarımı bağlar mı?
Hayır. OMNIAKEY_API_KEY'i MCP sunucusu veya CLI için ayrı yapılandırın. Skill ajana bu aracın nasıl kullanılacağını anlatır.
Skill komutları kendisi çalıştırır mı?
Hayır. Ajanınız talimatları ne zaman izleyeceğine ve hangi çağrıları yapacağına karar verir. Üretim hâlâ kullanıcı isteği gerektirir.