Coze'da Sıfırdan Eklentiler Nasıl Oluşturulur: CoinGecko

Not: Bu eğitim, Coze ve HackerNoon tarafından düzenlenen #AI-chatbot yazma yarışması kapsamındaki #AI Chatbot Tasarımı içindir!

Mükemmel bir dünyada, uygulamanız herkes için her şeyi yapardı ve her kullanıcı için her işlevi sunabilirdi. Ne yazık ki, hiçbir uygulama bu kadar güçlü değil, bu yüzden eklentiler oldukça önemlidir.

Eklentiler, uygulamalarınızın işlevselliğini ve yeteneğini sorunsuz bir şekilde genişleterek uygulamanız ile teknolojik ekosistemin geri kalanı arasındaki boşluğu kapatmaya yardımcı olur. En iyi yanı, eklentilerin bunu uygulamanızın kaynak kodunu doğal olarak etkilemeden yapmasıdır. Bu eğitim size Coze'de sıfırdan Eklentiler oluşturmayı öğretecektir.

Ama önce Eklentilerin ne olduğunu anlamaya çalışalım.

Eklenti Nedir?

Eklentiler, orijinal kodu yeniden yazmadan veya değiştirmeden uygulamanızın veya programlarınızın yeteneklerini artıran yazılım eklentileridir. Eklentiler bunu genellikle bir uygulama programlama arayüzü (API) veya çekirdek programın sunduğu diğer entegrasyon noktaları aracılığıyla uygulamanızın kod tabanına entegre olarak başarır. Süreç genellikle sorunsuzdur.

Geliştirici olarak sizin için eklentiler, kullanıcılarınıza tekerleği yeniden yatırmadan deneyimlerini iyileştirecek daha fazla özelleştirme, veri ve işlevsellik sağlamanıza olanak tanır. Kullanıcılar için bu, uygulamadayken daha iyi bir deneyim anlamına gelir.

Coze Nedir?

Coze, kullanıcıların sosyal platformlar aracılığıyla düşük kodlu/kodsuz bir yaklaşım kullanarak AI botları oluşturmasına, özelleştirmesine ve dağıtmasına olanak tanıyan bir platformdur. Bu nedenle, AI chatbot sürecinin tamamını herkes için demokratikleştiriyor. Platform ayrıca, AI botlarının işlevselliğini özelleştirmenize ve genişletmenize yardımcı olan araçlar, eklentiler, çoklu ajan modu ve bilgi ve bellek özellikleriyle birlikte gelir.

Diğer platformlar gibi Coze de çeşitli endüstrilere göre uyarlanmış çeşitli resmi Eklentiler sunar. GPT4V, CapCut, Doc Reader ve X gibi bu Eklentiler, haber ve okuma, fotoğrafçılık, yaşam tarzı, bilim, eğitim ve finans gibi birden fazla kategorideki belirli ihtiyaçları karşılar.

Ek olarak, kullanıcılar özel Eklentiler gönderebilirler. Bu eğitimde, kullanıcıların kripto fiyatlarından piyasa değerine ve işlem hacmine kadar çeşitli coin istatistiklerini takip etmelerine olanak tanıyan bir kripto para veri toplayıcı platformu olan CoinGecko için bir tane oluşturacaksınız.

Coze hakkında daha fazla bilgi edinmek için resmi Coze kullanıcı kılavuzuna göz atın.

Coze'da CoinGecko eklentisi nasıl oluşturulur?

Coze'da çeşitli yollarla Eklentiler oluşturabilirsiniz. Bu yollardan bazıları şunlardır:

• Mevcut bir API servisini içe aktarma.
• JSON veya YAML dosyalarını içe aktarma.
• Kod ayrıştırıcısı aracılığıyla.
• Coze IDE aracılığıyla.
• Bir eklentiye araçlar eklemek.

Bu kılavuzda, CoinGecko eklentisini oluşturmak için Coze IDE yolunu keşfedeceksiniz. Coze IDE, Node.js veya Python'da oluşturmanıza olanak tanıyan web tabanlı bir entegre geliştirme ortamıdır.

Ön koşullar

Bu eğitimi takip edebilmek için aşağıdakilere ihtiyacınız olacak:

• Bir Coze hesabı .
• Bir CoinGecko geliştirici hesabı. Ücretsiz bir hesap yeterli olacaktır, çünkü API'lerine temel erişime ihtiyacınız var.

Coze IDE aracılığıyla Coze Eklentisi Oluşturma

CoinGecko eklentinizi oluşturmak için şu adımları izleyin.

1. Coze.com'a giriş yapın ve çalışma alanı panelinden ekip alanınızı ziyaret edin.

2. Eklentiler sekmesine tıklayın ve Eklenti Oluştur'a tıklayın. Alternatif olarak, aracının Geliştirme sayfasını ziyaret edip Eklentiler oluşturabilirsiniz.

3. Eklentinize bir ad, açıklama ve bir simge (isteğe bağlı) ekleyin.

4. Eklenti Aracı oluşturma yöntemi açılır menüsünün altında Cloud Eklentisi - Coze IDE'de Oluştur'u seçin.

5. IDE çalışma zamanı altında tercih ettiğiniz dil olarak Python'ı seçin.

6. Aracınızı oluşturmak için Eklenti sayfasına yönlendirilmek üzere Onayla'ya tıklayın.

   
   

   

   
   

   Coze Eklentiniz İçin Bir Araç Oluşturma

   Daha sonra Eklenti aracınızı oluşturmanız gerekiyor.

   
   

7. Eklenti sayfasında IDE'de Araç Oluştur'a tıklayın.

8. Aletinize bir isim ve açıklama verin.

9. Aracınızı kodlayabileceğiniz Coze IDE sayfasına yönlendirilmek için Onayla'ya tıklayın.

Coze Eklentinizi Kodlama

1. Bağımlılıkları eklemek için solunuzdaki Paketler panelindeki + simgesine tıklayın. Burada, HTTP gönderebilmemiz için r equests paketini yüklemeniz gerekir.

   

   
   

   Oraya herhangi bir paketi kurduğunuzda eklentinizdeki herhangi bir araç tarafından kullanılabilir.

   
   

2. CoinGecko API anahtarınızı almak için CoinGecko geliştirici panelini ziyaret edin.

3. Kod sekmesinde, Coze tarafından sağlanan şablona göre kodunuzu yazın. İşleyici yöntemini silmemeniz veya değiştirmemeniz önemlidir, çünkü bu bir hataya neden olur. Temel URL kimlik doğrulama belgelerinden alındı.

 from runtime import Args import requests API_KEY = "****" BASE_URL = "https://api.coingecko.com/api/v3" def get_coin_data(coin_id: str, currency: str = "usd", logger=None): endpoint = f"{BASE_URL}/coins/markets" params = { "vs_currency": currency, "ids": coin_id.lower(), # Convert to lowercase "x_cg_demo_api_key": API_KEY } try: response = requests.get(endpoint, params=params) response.raise_for_status() # Raise an exception for bad status codes data = response.json() if logger: logger.info(f"API Response: {data}") return data except requests.RequestException as e: if logger: logger.error(f"API Request failed: {str(e)}") return {"error": f"API request failed: {str(e)}"} def handler(args: Args) -> dict: args.logger.info(f"Received args: {args}") args.logger.info(f"Type of args.input: {type(args.input)}") args.logger.info(f"Content of args.input: {args.input}") # Handle CustomNamespace object if hasattr(args.input, 'coin_id') and hasattr(args.input, 'currency'): coin_id = getattr(args.input, 'coin_id', 'bitcoin') currency = getattr(args.input, 'currency', 'usd') else: return { "message": f"Error: Invalid input format. Expected CustomNamespace with coin_id and currency attributes. Input: {args.input}", "data": None } args.logger.info(f"Processed input - coin_id: {coin_id}, currency: {currency}") try: coin_data = get_coin_data(coin_id, currency, args.logger) if "error" in coin_data: return { "message": f"Error: {coin_data['error']}", "data": None } else: # Check if we got any data if not coin_data: return { "message": f"No data found for {coin_id}", "data": None } # Assuming the API returns a list with one item for the specified coin coin_info = coin_data[0] if coin_data else {} return { "message": f"Successfully retrieved data for {coin_id}", "data": { "name": coin_info.get("name"), "symbol": coin_info.get("symbol"), "current_price": coin_info.get("current_price"), "market_cap": coin_info.get("market_cap"), "price_change_24h": coin_info.get("price_change_24h") } } except Exception as e: args.logger.error(f"An error occurred: {str(e)}") return { "message": f"An error occurred while processing the request: {str(e)}", "data": None } 

4. Araç için meta veri eklemek üzere Meta Veri sekmesine tıklayın.
5. Bunları CoinGecko API aracına giriş ve çıkış parametreleri olarak eklemek için Düzenle ve Parametreleri Ekle'ye tıklayın. Bunlar parametrelerinizdir:

   • Giriş parametreleri: coin_id (dize): Kripto para biriminin kimliği (örneğin, "bitcoin", "ethereum").

   • Giriş parametreleri: para birimi (dize): Piyasa verileri için hedef para birimi (örneğin, "usd", "eur")

   • Çıktı parametreleri: mesaj (dize): İsteğin durumunu belirten bir mesaj.

   • Çıktı parametreleri: veri (nesne): Bu veri nesnesi içerisinde bu parametreleri kullanın.

   • Veri çıkış parametreleriniz içinde: name (string): Kripto paranın adı.

   • Veri çıkış parametreleriniz içinde: sembol (dize): Kripto paranın sembolü.

   • Veri çıkış parametreleriniz içinde: current_price (sayı): Belirtilen para birimindeki geçerli fiyat.

   • Veri çıkış parametreleriniz içinde: market_cap (sayı): Belirtilen para birimindeki piyasa değeri.

   • Veri çıkış parametreleriniz içinde: price_change_24h (sayı): Son 24 saatteki fiyat değişimi

     
     

     

     
     

Meta veriler, Coze aracınızın kullanıcılardan ne beklemesi gerektiğini ve ne çıkarması gerektiğini ve kullanıcılara nasıl cevap vereceğini bilmesini sağlar.

Coze Eklentinizi Test Etme ve Yayınlama

1. Eklentinizi test etmek için Test Kodu sekmesi altında giriş parametrenizi girin ve çalıştırın.

2. Çalıştır'a tıklayın.

   

   
   

3. Aletinizin yanıtını görüntülemek için Çıkış Değerini görüntüleyin.

4. Başarılı olup olmadığını veya herhangi bir hata olup olmadığını görmek için Konsol panelindeki günlükleri görüntüleyin.

5. Test başarılı olursa eklentinizi yayınlamak için Yayımla'ya tıklayın.

6. Gizlilik Toplama Beyanı iletişim kutusunda Hayır'ı işaretleyin, çünkü eklentimiz kullanıcı verilerini toplamaz. Ancak eklentiniz kullanıcı verileri gerektiriyorsa Evet'i işaretleyin.

   
   

   

   
   

   
   

7. Yayımla'ya tıklayın. Mağazaya gidin ve bu CoinGecko eklentisini keşfedin.

   Eklenti Nedir?

   Eklentiler, kaynak kodunuzu değiştirmeden uygulamalarınızın yeteneklerini entegre etmenin ve genişletmenin etkili yollarıdır. Coze eklentisi özelliklerini kullanarak, AI uygulamaları oluşturabilir ve Coze'nin resmi eklentilerinden herhangi biriyle entegre olarak özelliklerini genişletebilirsiniz.

   
   

   İstediğiniz eklentiyi bulamıyor musunuz? Artık seçtiğiniz herhangi bir API ile zahmetsizce özel bir eklenti oluşturabilirsiniz. Bu, kullanıcı etkileşiminizi geliştirmenizi ve uygulamanızın özelliklerini genişletmenizi kolaylaştırır. YouTube'larını inceleyerek araç hakkında daha fazla bilgi edinin.

   
   

   Buraya kadar okuduysanız, minnettarım! Twitter , LinkedIn veya iheifeanyi [at] gmail.com adresinden benimle iletişime geçebilirsiniz.

   
   

   Lütfen beğenin veya yorum yapın. Teşekkürler! ❤️🚀🙏🏽