Kako stvoriti dodatke od nule u Coze: CoinGecko

P.s. Ovaj vodič je za #AI Chatbot Design u okviru #AI-chatbot natjecanja za pisanje Cozea i HackerNoona!

U savršenom svijetu vaša bi aplikacija bila sve za svakoga i mogla bi isporučiti svaku funkciju za svakog korisnika—Nažalost, nijedna aplikacija nije tako moćna kao ta, stoga su dodaci vrlo važni.

Dodaci pomažu premostiti jaz između vaše aplikacije i ostatka tehnološkog ekosustava besprijekornim proširenjem funkcionalnosti i mogućnosti vaših aplikacija. Najbolji dio je što dodaci to rade bez utjecaja na izvorni kod vaše aplikacije. Ovaj vodič će vas naučiti kako stvoriti dodatke od nule u Cozeu.

Ali prvo, pokušajmo shvatiti što su dodaci.

Što je dodatak?

Dodaci su softverski dodaci koji poboljšavaju mogućnosti vaše aplikacije ili programa bez ponovnog pisanja ili mijenjanja izvornog koda. Dodaci to često postižu integracijom u bazu koda vaše aplikacije putem sučelja za programiranje aplikacija (API) ili bilo koje druge točke integracije koju nudi osnovni program. Proces je obično besprijekoran.

Za vas, programera, dodaci vam omogućuju da svojim korisnicima pružite više prilagodbi, podataka i funkcionalnosti koje će poboljšati njihovo iskustvo bez ponovnog ulaganja u kotačić. Za korisnike to znači bolje iskustvo dok koriste aplikaciju.

Što je Coze?

Coze je platforma koja korisnicima omogućuje izradu, prilagodbu i implementaciju AI robota koristeći pristup s niskim kodom/bez koda putem društvenih platformi. Dakle, prilično demokratizira cijeli proces AI chatbota za sve. Platforma također dolazi s alatima, dodacima, načinom rada s više agenata te značajkama znanja i memorije koje vam pomažu prilagoditi i proširiti funkcionalnost njihovih AI robota.

Kao i druge platforme, Coze nudi različite službene dodatke prilagođene različitim industrijama. Ovi dodaci, kao što su GPT4V, CapCut, Doc Reader i X, zadovoljavaju specifične potrebe u više kategorija, uključujući vijesti i čitanje, fotografiju, stil života, znanost, obrazovanje i financije.

Osim toga, korisnici mogu poslati prilagođene dodatke. U ovom vodiču izradit ćete jedan za CoinGecko , platformu za prikupljanje podataka o kriptovalutama koja korisnicima omogućuje praćenje različitih statistika novčića, od cijena kriptovalute do tržišne kapitalizacije i volumena trgovanja.

Provjerite službeni Coze korisnički priručnik kako biste saznali više o Cozeu.

Kako izgraditi CoinGecko dodatak u Cozeu?

U Cozeu možete graditi dodatke na razne načine. Neki od ovih načina su:

• Uvoz postojeće API usluge.
• Uvoz JSON ili YAML datoteka.
• Preko parsera koda.
• Putem Coze IDE-a.
• Dodavanje alata u dodatak.

U ovom vodiču istražit ćete Coze IDE rutu za izradu CoinGecko dodatka. Coze IDE integrirano je razvojno okruženje temeljeno na webu koje vam omogućuje izgradnju u Node.js ili Python.

Preduvjeti

Da biste pratili ovaj vodič, trebat će vam sljedeće:

• Coze račun .
• Račun razvojnog programera CoinGecko. Besplatni račun će poslužiti jer vam je potreban osnovni pristup njihovom API-ju .

Izrada Coze dodatka putem Coze IDE-a

Slijedite ove korake kako biste izgradili svoj CoinGecko dodatak.

1. Prijavite se na Coze.com i posjetite svoj timski prostor unutar ploče radnog prostora.

2. Pritisnite karticu Dodaci i kliknite Stvori dodatak . Alternativno, možete posjetiti agentovu stranicu za razvoj i izraditi dodatke.

3. Dajte svom dodatku naziv, opis i ikonu (nije obavezno).

4. Odaberite Cloud Plugin - Create in Coze IDE pod padajućim izbornikom Metoda izrade alata za dodatke .

5. Odaberite Python kao jezik po izboru pod IDE runtimeom .

6. Kliknite Potvrdi da biste bili preusmjereni na stranicu Dodatka za izradu svog alata.

   
   

   

   
   

   Izrada alata za vaš Coze dodatak

   Zatim trebate izraditi svoj alat za dodatke.

   
   

7. Pritisnite Stvori alat u IDE- u na stranici Dodatka .

8. Dajte svom alatu naziv i opis.

9. Kliknite Potvrdi za preusmjeravanje na stranicu Coze IDE , gdje možete kodirati svoj alat.

Kodiranje vašeg Coze dodatka

1. Kliknite ikonu + na ploči Paketi s vaše lijeve strane za dodavanje ovisnosti. Ovdje morate instalirati paket zahtjeva kako bismo mogli poslati HTTP.

   

   
   

   Instaliranje bilo kojeg paketa tamo omogućuje da ga koristi bilo koji alat u vašem dodatku.

   
   

2. Posjetite nadzornu ploču programera CoinGecko da biste dobili svoj CoinGecko API ključ.

3. Unutar kartice Kod, napišite svoj kod na temelju predloška koji je dao Coze. Važno je da ne brišete niti modificirate metodu rukovatelja jer bi to uzrokovalo kvar. Osnovni URL preuzet je iz dokumenata za provjeru autentičnosti.

 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. Pritisnite karticu Metapodaci za dodavanje metapodataka za alat.
5. Kliknite Uredi i Dodaj parametre kako biste ih dodali kao ulazne i izlazne parametre u CoinGecko API alat. Ovo su vaši parametri:

   • Ulazni parametri: coin_id (string): ID kriptovalute (npr. "bitcoin", "ethereum").

   • Ulazni parametri: valuta (string): ciljna valuta za tržišne podatke (npr. "usd", "eur")

   • Izlazni parametri: poruka (string): Poruka koja pokazuje status zahtjeva.

   • Izlazni parametri: podaci (objekt): Unutar ovog podatkovnog objekta koristite ove parametre.

   • Unutar izlaznih parametara podataka: ime (string): naziv kriptovalute.

   • Unutar vaših izlaznih parametara podataka: simbol (string): simbol kriptovalute.

   • Unutar izlaznih parametara podataka: current_price (broj): trenutna cijena u navedenoj valuti.

   • Unutar vaših izlaznih parametara podataka: market_cap (broj): tržišna kapitalizacija u navedenoj valuti.

   • Unutar izlaznih parametara vaših podataka: price_change_24h (broj): Promjena cijene u zadnja 24 sata

     
     

     

     
     

Metapodaci omogućuju vašem Coze alatu da zna što očekivati i izvući od korisnika te kako odgovoriti korisnicima.

Testiranje i objavljivanje vašeg Coze dodatka

1. Unesite svoj ulazni parametar pod karticu Testni kod za testiranje i pokrenite svoj dodatak.

2. Pritisnite Pokreni .

   

   
   

3. Pogledajte izlaznu vrijednost kako biste vidjeli odziv vašeg alata.

4. Pregledajte zapisnike na konzolnoj ploči da biste vidjeli je li bilo uspješno ili je došlo do pogreške.

5. Kliknite Objavi da objavite svoj dodatak ako je test uspješan.

6. Označite Ne u dijaloškom okviru Izjava o prikupljanju privatnosti jer naš dodatak ne prikuplja korisničke podatke. Međutim, ako vaš dodatak zahtijeva korisničke podatke, označite Da .

   
   

   

   
   

   
   

7. Pritisnite Objavi . Idite u trgovinu i istražite ovaj CoinGecko dodatak .

   Što je dodatak?

   Dodaci su učinkoviti načini za integraciju i proširenje mogućnosti vaših aplikacija bez mijenjanja izvornog koda. Iskorištavanjem značajki Coze dodataka, možete izraditi AI aplikacije i proširiti njihove značajke integracijom s bilo kojim od Coze službenih dodataka.

   
   

   Ne možete pronaći dodatak koji želite? Sada možete bez napora izraditi prilagođeni dodatak s bilo kojim API-jem koji odaberete. To olakšava povećanje vašeg angažmana korisnika i proširenje značajki vaše aplikacije. Saznajte više o alatu istražujući njihov YouTube .

   
   

   Ako ste pročitali dovde, cijenim to! Možete se povezati sa mnom na Twitteru , LinkedInu ili iheifeanyi [at] gmail.com

   
   

   Ostavite lajk ili komentar. Hvala! ❤️🚀🙏🏽