Agno, hızla üretim sınıfına dönüşüyor AgentOS—çoklu ajan sistemleri için bir çalışma zamanı, çerçeve ve kontrol düzlemi— ve CometAPI ("tüm modeller tek bir API'de" toplayıcısı), Agno için bir model sağlayıcısı olarak resmi desteğini duyurdu. Birlikte, ajan kodunuzu yeniden yazmadan yüzlerce model uç noktası arasında geçiş yapabilen çoklu ajan sistemlerini çalıştırmayı kolaylaştırıyorlar. Bu nedenle, Agno gibi ajan çerçeveleri için anında model sağlayıcısı olarak CometAPI gibi birleşik ağ geçitlerinin kullanılmasına olan talep artıyor. Dolayısıyla, aşağıda açıkladığımız model hem pratik hem de güncel.
Agno ve CometAPI tam olarak nedir?
Agno nedir ve neden önemsemeliyim?
Agno, bellek, araçlar, bilgi ve insan-devir desteğiyle aracılar, ekipler ve aracı iş akışları oluşturmak için tasarlanmış, yüksek performanslı, Pythonic çoklu aracı çerçevesi, çalışma zamanı ve kullanıcı arayüzüdür. Hazır bir FastAPI çalışma zamanı (AgentOS), yerel geliştirme araçları ve bir kontrol düzlemi kullanıcı arayüzü sunar; böylece verileri ortamınızdan dışarı göndermeden çalışan aracıları test edebilir ve izleyebilirsiniz. Üretim düzeyinde aracı sistemlerini hızla oluşturmak ve veriler ile gözlemlenebilirlik üzerinde tam kontrol sahibi olmak istiyorsanız, Agno tam da bu kullanım senaryosu için tasarlanmıştır.
CometAPI nedir ve neden bir LLM sağlayıcısı olarak bunu kullanmalıyım?
CometAPI, onlarca hatta yüzlerce LLM ve modaliteye (metin, resim, video vb.) tek ve tutarlı bir API sağlayan bir API toplayıcı/model ağ geçididir. Geliştiriciler, tek bir model sağlayıcısına bağlanmak yerine CometAPI ağ geçidini çağırır ve parametreler aracılığıyla sağlayıcılar veya modeller arasında geçiş yapabilirler; bu da maliyet yönetimi, A/B testleri ve geri dönüşler için kullanışlıdır. Platform, modeller arasında geçişi, birleşik faturalandırmayı ve OpenAI uyumlu uç noktaları talep etmeyi destekler; yani, genellikle OpenAI tarzı bir istemciyi CometAPI'nin temel URL'sine ve kimlik doğrulama belirtecine yönlendirebilir ve modelleri OpenAI uç noktalarıymış gibi çağırabilirsiniz. Bu, CometAPI'yi halihazırda OpenAI API arayüzünü konuşan çerçeveler için kullanışlı bir "eklenti" sağlayıcı haline getirir.
Son sinyal: CometAPI, bir model sağlayıcı olarak duyuruldu Agno'nun resmi belgeleri ve topluluk kanalları, yani Agno'nun bir CometAPI model sağlayıcı sınıfınıza geçirebileceğiniz AgentBu, ağ geçidinin entegrasyonunu basit ve destekli hale getirir.
Agno'yu CometAPI ile neden entegre etmeliyiz?
- Sağlayıcıya bağlılık yok: CometAPI, SDK'ları değiştirmeden birçok modelle (OpenAI, Claude, LLama varyantları, Gemini vb.) denemeler yapmanıza olanak tanır. Bu, Agno'nun modelden bağımsız tasarımını tamamlar.
- Daha hızlı geliştirme döngüsü: CometAPI, OpenAI tarzı uç noktaları desteklediğinden, genellikle özel bir Agno sağlayıcısı yazmaktan kaçınırsınız; Agno'nun OpenAI model adaptörünü CometAPI'ye yönlendirebilir ve başlayabilirsiniz.
- Gözlemlenebilirlik + kontrol: Modelleri CometAPI aracılığıyla çevirirken ajanları yerel olarak veya bulutunuzda çalıştırmak için Agno'nun AgentOS çalışma zamanını ve kontrol düzlemini kullanın; böylece model esnekliği ve çalışma zamanı gözlemlenebilirliğinin en iyilerini birleştirin.
Agno'yu CometAPI ile adım adım nasıl entegre edersiniz?
Aşağıda sanal ortam oluşturulmasından CometAPI aracılığıyla modelleri çağıran yerel bir AgentOS örneğinin çalıştırılmasına kadar pratik, kopyalanıp yapıştırılabilir bir iş akışı bulunmaktadır.
Anahtar fikir: CometAPI, OpenAI uyumlu bir uç noktayı açığa çıkardığından, en basit yaklaşım Agno'nun OpenAI model adaptörünü kullanmak ve noktayı belirlemektir.
OPENAI_API_BASE(Ya daopenai.api_base) CometAPI'nin temel URL'sinde, CometAPI token'ınızı OpenAI API anahtarı olarak sağlarken. CometAPI, bu "base_url'yi değiştir + OpenAI formatını kullan" akışını açıkça belgelendirir.
Başlamadan önce ihtiyaç duyacağınız ortam ve ön koşullar
Hangi işletim sistemi, Python sürümü ve araçlar önerilir?
- OS: macOS, Linux veya Windows — Agno ve araçları üçünü de destekler. ()
- Piton: Modern bir CPython kullanın (Agno belgeleri ve deposu modern Python sürümlerini hedefler; Python 3.12 kullanmanızı öneririz). Üretim dağıtımlarından önce Agno'nun deposunu/belgelerini tam uyumluluk açısından kontrol edin.
- Paket yöneticisi / virtualenv:
uv(Astraluv(proje) sanal ortamları ve bağımlılıkları yönetmek için mükemmel ve hızlı bir seçenektir.
Hangi hesapları, anahtarları ve ağ ön koşullarını hazırlamanız gerekir?
- CometAPI hesabı ve API anahtarı. Anahtarınızı CometAPI'den alın ve bir ortam değişkeninde saklayın (
COMETAPI_KEY). Agno'nun CometAPI model adaptörü şunu okur:COMETAPI_KEY. - İsteğe bağlı Agno Kontrol Düzlemi hesabı (AgentOS UI). İzleme veya ekip özellikleri için Kontrol Düzlemine yerel bir AgentOS bağlamayı planlıyorsanız, Kontrol Düzlemi erişiminizi ve org/ekip izinlerinizi hazır bulundurun.
- Ajan durumu için veritabanı (isteğe bağlı). Kalıcılık için genellikle ölçeğe bağlı olarak SQLite/Postgres'i yapılandırırsınız; Agno'nun yerel dev için SQLite'ı gösteren örnekleri vardır.
Agno'yu CometAPI ile adım adım nasıl entegre edersiniz?
Aşağıda sanal ortam oluşturulmasından CometAPI aracılığıyla modelleri çağıran yerel bir AgentOS örneğinin çalıştırılmasına kadar pratik, kopyalanıp yapıştırılabilir bir iş akışı bulunmaktadır.
Anahtar fikir: CometAPI, OpenAI uyumlu bir uç noktayı açığa çıkardığından, en basit yaklaşım Agno'nun OpenAI model adaptörünü kullanmak ve noktayı belirlemektir.
OPENAI_API_BASE(Ya daopenai.api_base) CometAPI'nin temel URL'sinde, CometAPI token'ınızı OpenAI API anahtarı olarak sağlarken. CometAPI, bu "base_url'yi değiştir + OpenAI formatını kullan" akışını açıkça belgelendirir.
1) Yükle uv ve sanal ortamı yaratın
uv yükleyici (tek satır):
# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
Yeniden üretilebilir bir venv oluşturun ve etkinleştirin (Agno hızlı başlangıç Python 3.12 kullanır):
# create a venv managed by uv
uv venv --python 3.12
# activate (POSIX)
source .venv/bin/activate
(Eğer geleneksel olanı tercih ediyorsanız python -m venv .venv bu da işe yarıyor; uv (lockfile + yeniden üretilebilirlik avantajları sağlar.)
2) Agno ve çalışma zamanı bağımlılıklarını yükleyin (aracılığıyla) uv pip)
```bash
uv pip install -U agno openai mcp 'fastapi' sqlalchemy 'httpx'
# optionally, add extras you need
uv pip install -U agno # if using cloud infra plugins
(ihtiyacınız olan diğer kütüphaneleri kurun: vektör DB istemcileri, izleme kütüphaneleri, vb.)
Agno'nun genellikle kurulumu `agno` + sağlayıcı SDK'ları.
### 3) CometAPI API anahtarını dışa aktarın
Agno Comet sağlayıcısının okuyacağı ortam değişkenini ayarlayın:
bash
macOS / Linux
export COMETAPI_KEY="sk-xxxx-your-cometapi-key"
Windows (PowerShell)
setx COMETAPI_KEY "sk-xxxx-your-cometapi-key"
Agno'nun CometAPI sağlayıcısı varsayılan olarak okumayı kullanır `COMETAPI_KEY`.
### 4) CometAPI sağlayıcısını kullanan küçük bir Agno Aracısı oluşturun
Klasörü açın ve yeni bir dosya oluşturun. Aşağıdakini şu şekilde kaydedin: `comet_agno_agent.py`:
from agno.agent import Agent
from agno.db.sqlite import SqliteDb
from agno.models.cometapi import CometAPI
from agno.os import AgentOS
from agno.tools.mcp import MCPTools
1) Create an Agent which uses CometAPI as the model provider
id parameter selects a model id from the CometAPI catalog
agno_agent = Agent(
name="Agno Agent",
model=CometAPI(id="gpt-5-mini"),
# Add a database to the Agent
db=SqliteDb(db_file="agno.db"),
# Add the Agno MCP server to the Agent
tools=,
# Add the previous session history to the context
add_history_to_context=True,
markdown=True,
)
2) Attach Agent to AgentOS and get FastAPI app
agent_os = AgentOS(agents=)
Get the FastAPI app for the AgentOS
app = agent_os.get_app()
### 5) Test etmek için Agno'yu yerel olarak çalıştırın
AgentOS (FastAPI) dev sunucusunu başlatın:
In the activated .venv (uv-managed)
fastapi dev agno_comet_agent.py
defaults to http://localhost:8000
Açılış `http://localhost:8000/docs` otomatik olarak oluşturulan uç noktaları denetlemek için.
> Ortam değişkenlerinin (COMETAPI\_KEY\_API\_KEY) ayarlandığından emin olun
### 6) Yerel AgentOS'unuzu AgentOS Kontrol Düzlemine bağlayın (isteğe bağlı)
Agno web kontrol düzleminin yerel AgentOS'unuzu izlemesini istiyorsanız:
1. AgentOS Kontrol Düzlemini ziyaret edin: `os.agno.com` ve giriş yapın.
2. Tıkla **Yeni işletim sistemi ekle → Yerel**, girmek `http://localhost:8000`, ona bir isim verin ve **Bağlantı Kurun**.
Bağlandığınızda sohbet, oturumlar, ölçümler ve yönetim için web kullanıcı arayüzüne erişirsiniz.
## Yapılandırma ve güvenlik açısından en iyi uygulamalar nelerdir?
### Sırlar ve API anahtarları
API anahtarlarını asla işlemeyin. Ortam değişkenlerini, bir sır yöneticisini veya `.env` yerel ile birleştirilmiş `.gitignore`En iyi uygulama: Anahtarları düzenli olarak döndürün ve sağlayıcı destekliyorsa IP'ye göre kullanımını kısıtlayın. (OpenAI belgeleri ve diğer satıcılar ortam değişkenlerini önermektedir.)
### Model seçimi ve maliyet kontrolü
Uygun maliyet/gecikme dengelerine sahip modelleri seçmek için CometAPI'nin model kataloğunu kullanın. Mantıklı hız sınırları koyun ve üstel geri çekilmeli yeniden denemeler uygulayın. CometAPI, model listelerini ve fiyatlandırmayı belgelerinde sunar.
### İzlenebilirlik
Aracı günlükleri, oturum izleri ve ölçümler için Agno'nun AgentOS kontrol düzlemini kullanın. Maliyetleri/gecikmeyi aracı etkinliğiyle ilişkilendirmek için bunu sağlayıcı düzeyindeki ölçümlerle (CometAPI panosu) birleştirin.
### Gizlilik ve veri saklama
AgentOS bulutunuzda çalıştığı için oturum verilerinin kontrolü sizde kalır. Yine de, politika tarafından açıkça izin verilmedikçe hassas kişisel bilgileri (PII) üçüncü taraf modellere göndermekten kaçının; gerekirse şirket içi veya özel model barındırma kullanın.
## En iyi uygulamalar ve önerilen kullanım örnekleri nelerdir?
### En iyi uygulamalar
- **Küçük başla:** Ölçeklemeden önce bir geliştirme aracı ve düşük seviyeli bir model (daha ucuz) ile test edin.
- **Model geri dönüşü:** bir yedek zincir uygulayın (örneğin, daha ucuz küçük model → arıza durumunda daha güçlü model). CometAPI, modellerin adlarına göre değiştirilmesini kolaylaştırır.
- **İnce taneli takımlama:** Ajanlara sınırlı, denetlenmiş araçlar (web araması, veritabanı erişimi) ve izlerle araç çağrıları sağlayın. Agno, araç entegrasyonları ve araçlandırılmış çağrılar için bir model sağlar.
- **Hız sınırlama ve toplu işleme:** Benzer istekleri toplu olarak işleyin ve dalgalanmaları önlemek için ağ geçidinde veya istemcide oran sınırlamaları uygulayın.
### Tipik kullanım durumları
- **RAG (Geri Alma-Artırılmış Üretim) sohbet robotları** — Belgeler için Agno ajanları + Dil üretimi için CometAPI.
- **Otomatik iş akışları** — Web kazıma araçlarını, vektör veritabanlarını ve üretken adımları birleştiren çoklu ajan iş akışları.
- **Prototipten üretime** — Farklı modelleri denemek için CometAPI'yi kullanarak hızlıca yineleme yapın, ardından seçilen sağlayıcıyı sabitleyin veya kurumsal bir sözleşmeye geçin.
## Comet API'yi kullanmaya nasıl başlanır?
CometAPI, OpenAI'nin GPT serisi, Google'ın Gemini, Anthropic'in Claude, Midjourney, Suno ve daha fazlası gibi önde gelen sağlayıcılardan 500'den fazla AI modelini tek bir geliştirici dostu arayüzde toplayan birleşik bir API platformudur. Tutarlı kimlik doğrulama, istek biçimlendirme ve yanıt işleme sunarak CometAPI, AI yeteneklerinin uygulamalarınıza entegrasyonunu önemli ölçüde basitleştirir. İster sohbet robotları, görüntü oluşturucular, müzik bestecileri veya veri odaklı analiz hatları oluşturuyor olun, CometAPI daha hızlı yineleme yapmanızı, maliyetleri kontrol etmenizi ve satıcıdan bağımsız kalmanızı sağlar; tüm bunları yaparken AI ekosistemindeki en son atılımlardan yararlanırsınız.
Başlamak için, model yeteneklerini keşfedin [Kuyrukluyıldız API'si](https://www.cometapi.com/tr/?utm_source=agno uted) içinde [Oyun Alanı](https://www.cometapi.com/console/playground) ve Devam'a danışın [API kılavuzu](https://apidoc.cometapi.com/continue-1624859m0) Ayrıntılı talimatlar için. Erişimden önce, lütfen CometAPI'ye giriş yaptığınızdan ve API anahtarını edindiğinizden emin olun. [Ile](https://www.cometapi.com/tr/)[e](https://www.cometapi.com/tr/?utm_source=agno uted)[tAPI](https://www.cometapi.com/tr/) Entegrasyonunuza yardımcı olmak için resmi fiyattan çok daha düşük bir fiyat teklif ediyoruz.
Gitmeye hazır mısınız?→ [Bugün CometAPI'ye kaydolun](https://api.cometapi.com/login) !
Yapay zeka hakkında daha fazla ipucu, kılavuz ve haber öğrenmek istiyorsanız bizi takip edin [VK](https://vk.com/id1078176061), [X](https://x.com/cometapi2025) ve [Katılın](https://discord.com/invite/HMpuV6FCrG)!
## Nihai düşünceler
Agno'yu CometAPI ile entegre etmek, esnek, gözlemlenebilir ve tedarikçiden bağımsız aracı sistemler oluşturmanız için pratik bir yol sunar. Agno çalışma zamanı ve kontrol düzlemini sağlar; CometAPI ise birçok modele tek bir ağ geçidi sağlar. İkisi birlikte operasyonel sürtünmeyi azaltır: aracı başına daha az model kurulumu, daha kolay deneme ve merkezi faturalandırma/kontroller.