Izradite AI pronalazač karata Commander uz Scryfall

Pronalazač karata za Scryfall Commander pretvara opis karte koja vam treba u pretragu koju možete pregledati. U ovom vodiču izradit ćete Open Query, Agent za Quickchat AI koji prikazuje svoj upit Scryfall, vraća stvarne zapise o kartama i objašnjava zašto bi svaki kandidat mogao odgovarati vašem špilu.

Počnite s jednim mjestom u mono-zelenom špilu Commander. Želite stvorenje s trampleom i cijenom ispod pet američkih dolara. Do kraja ćete moći upisati taj zahtjev, otvoriti vraćene karte i doraditi pretragu bez pamćenja svakog operatora.

Korisni dio dolazi kada zahtjev postane teži. “Draw when another creature enters” zvuči precizno, ali pretraga riječi enters i draw pronalazi i karte koje rade nešto drugo. Uočit ćete to nepodudaranje i suziti upit, koristeći vraćeni tekst karte kao dokaz.

Što ćete izraditi i što vam treba?

Povezat ćete jedan read-only API Action s Scryfall, dati Agentu njegove upute za pretraživanje i testirati ga u razgovoru. Action poziva fiksni URL. Model daje upit i broj stranice. Scryfall vraća zapise iz kojih odgovor crpi podatke.

1. Izradite račun Quickchat AI i Agent pod nazivom Open Query. Trebate dostupne AI kredite za razgovore i testove. Pogledajte trenutačne planove.
2. Držite Agentove Identity, Actions & MCPs i AI Preview pri ruci dok radite. Nije potreban prijenos zbirke karata.
3. Koristite javni API servisa Scryfall. Za ove pretrage ne trebate račun ni API ključ za Scryfall.

Početni paket sadrži Main Prompt, recept za Action, putanje response filtera i testne poruke. Primjeri koriste engleski Oracle tekst i cijene u USD. Kada pratite vodič na drugom jeziku, operatore upita i imena karata ostavite kako su napisani.

Korak 1: Kako zahtjev za kartom pretvoriti u upit Scryfall?

Upit Scryfall kombinira ograničenja odvojena razmacima. Za naš prvi zahtjev upotrijebite:

f:commander id<=g t:creature kw:trample usd<5

Dva mala izbora su važna. kw:trample traži ključnu riječ. o:trample traži riječ u Oracle tekstu. Stvorenje može spominjati trample, a da samo nema tu sposobnost. Testirali smo oboje. Pretraga teksta dala je širi skup.

“Odgovara mono-zelenom špilu” također se razlikuje od “ima točno zeleni identitet.” Prvo dopušta bezbojne karte. Za drugo koristite id=g, ili id<=ur za pretraživanje unutar boja plavo-crvenog commandera. To su ograničenja identiteta, a ne potpuna provjera legalnosti špila.

Referenca sintakse pretraživanja servisa Scryfall search syntax reference objašnjava ove operatore. Za ovaj vodič držite upit vidljivim u svakom odgovoru kako biste mogli primijetiti izostavljenu boju, neočekivanu valutu ili pretragu koja je šira od vašeg zahtjeva.

Korak 2: Kako povezati API Scryfall sa svojim Agentom?

Izradite jedan API Action koji šalje zahtjev GET na endpoint za pretraživanje karata servisa Scryfall. Njegove fiksne postavke biraju pružatelja i redoslijed, a njegova dva parametra Agentu omogućuju odabir pretrage i stranice.

1. Otvorite Actions & MCPs → Add Action → API Action.
2. Upotrijebite zahtjev za builder u nastavku, zatim pregledajte generirane postavke prema receptu. Vodič za builder API Action objašnjava tijek generiranja i pregleda.
3. Postavite API Action Name na Search Scryfall cards.

Create a read-only Scryfall card-search Action using GET https://api.scryfall.com/cards/search. Add required Text query and Integer page parameters. Map q to query and page to page in Query Params. Fix unique=cards and order=name. Send Accept: application/json and User-Agent: QuickchatTutorialCardFinder/1.0 (+https://quickchat.ai). No authentication and no request body. Fetch one page only. Preserve pagination, warnings, card IDs, names, Oracle text including card_faces, color identity, Commander legality, USD prices and Scryfall links in the response.

Definirajte dva parametra

Pod What to ask the user first dodajte ove obavezne parametre. Agent ih može popuniti iz razgovora. Oznaka ne znači da vas mora tražiti da ručno upišete sirovu sintaksu upita.

Postavite endpoint, parametre upita i zaglavlja

Odaberite GET i unesite:

https://api.scryfall.com/cards/search

Pod Query Params dodajte četiri retka u nastavku. Za dinamičke vrijednosti upotrijebite Add AI Data za odabir parametra koji ste izradili. Oznake {{query}} i {{page}} u nastavku predstavljaju te čipove parametara.

Koristite polja parametara upita kako bi razmaci, navodnici i operatori bili kodirani kao vrijednosti parametara. URL endpointa neka ostane fiksan.

Ostavite Body praznim. Autentikacija nije potrebna. User-Agent je identifikacijski naziv klijenta, a ne vjerodajnica. Pri implementaciji svoje verzije upotrijebite vlastiti odgovarajući naziv aplikacije i URL za kontakt.

Zadržite odgovor korisnim

Stranica Scryfall može sadržavati mnogo zapisa. Zadrži polja koja Agent treba, zajedno s informacijama koje mu govore postoje li dodatne stranice. Proširi Advanced settings i pronađi Response filter. Upotrijebi Add JSONPath, a zatim gumb plus, da dodaš svaku putanju u nastavku kao zaseban unos:

$.total_cards
$.has_more
$.next_page
$.warnings
$.data[*].id
$.data[*].name
$.data[*].oracle_text
$.data[*].card_faces
$.data[*].color_identity
$.data[*].legalities.commander
$.data[*].prices.usd
$.data[*].scryfall_uri

Zadržite card_faces. Neke karte svoj tekst stavljaju na pojedinačna lica umjesto na najvišu razinu. Zadržite i warnings: HTTP uspjeh ne znači da je Scryfall svaku klauzulu protumačio kako je zamišljeno. Referenca objekta Card opisuje ta polja.

U API Action Description zalijepite:

Use when a player wants to find real cards matching a confirmed request. Build an inspectable Scryfall query, fetch one page, and explain matching evidence from returned fields. Show the executed query and any returned warnings. Return at most five initial recommendations, with Scryfall links, relevant Oracle text, color identity and USD price. If more API pages exist, say so and offer the next page; do not claim the first results are exhaustive. Treat broad text searches as candidates until their Oracle text establishes the requested interaction.

Spremite Action i provjerite je li aktivan. Vodič o anatomiji HTTP Actiona objašnjava kako parametri, zahtjev i opis rade zajedno.

Korak 3: Kako bi pronalazač karata trebao objašnjavati svoje rezultate?

Agent treba upute da prikaže svoj upit, utemelji preporuke na vraćenim zapisima i razlikuje podudaranje riječi od interakcije pravila. Otvorite Identity → Main Prompt i zalijepite potpuni prompt iz početnog paketa, reproduciran u nastavku.

You are Open Query, a Commander card-search helper. Clarify format, color identity and budget currency when needed. Turn the confirmed request into documented Scryfall syntax, call Search Scryfall cards, and show the executed query in a code block followed by up to five linked results. Recommend only records returned by this Action. Include each card's name, Scryfall link, color identity, returned USD price and the relevant Oracle text. Summarize without inventing text or cards. Use periods or semicolons rather than em dashes. Use text on card_faces when present.
For mono-green deck eligibility use id<=g; this includes colorless. For exactly green identity use id=g. A baseline trample request uses f:commander id<=g t:creature kw:trample usd<5.
Separate word matches from rules interpretation. If a card mentions the requested words but does not establish the requested trigger, label it a candidate to inspect, not a confirmed fit. Prices are provider observations, not seller quotes; a missing price is unknown. Say the total result count and whether more API pages exist. Start at page 1. Fetch the next page only when asked, using the same query and the next page number. Never fetch every page automatically. A shortlist is not exhaustive. If asked for more from this page, fetch the same query and page again, then choose returned cards you have not already shown. The next API page is different.
Do not build a full deck, invent cards, or claim a rules ruling. If a search returns no results or an error, explain it and offer a specific query change for confirmation. Inspect response warnings as well as errors. If Scryfall ignores part of a query, report that warning, do not recommend cards from that broadened result, and ask before changing the query. Do not silently retry an altered query. If rate limited, stop and ask the reader to try later.

Sada otvorite AI Preview i pošaljite:

Find Commander-legal creatures in mono-green color identity with trample, priced below 5 USD.

Demo je podobnost za mono-zeleni špil protumačio kao zelenu ili bezbojnu. Za točno zeleni identitet recite to izričito.

Pročitajte izvršeni upit prije preporuka. Trebao bi sačuvati Commander, zeleni-ili-bezbojni identitet, tip stvorenja, trample i USD ispod 5. Otvorite poveznicu Scryfall jedne karte i usporedite relevantni tekst, identitet i cijenu s odgovorom. Cijena je opažanje iz pretrage za vraćeni print, a ne ponuda za naplatu.

API rezultati poredani su po nazivu, a ne rangirani prema prikladnosti. Agent bira kratki popis s dohvaćene stranice. unique=cards izbjegava navođenje svakog printa kao zasebnog rezultata. To ne znači da je odabrani zapis najjeftiniji primjerak koji možete kupiti.

Korak 4: Kako popraviti pretragu koja pronalazi pogrešnu interakciju?

Suzite upit tako da pročitate protuprimjer i dodate uvjet koji nedostaje. Tijekom dorade zadržite razliku između pronalaženja kandidata i potvrđivanja njihova teksta.

Pitajte:

Find green cards that draw when another creature enters, under 5 USD.

Široka pretraga kandidata glasi:

f:commander id<=g o:enters o:draw usd<5

U našoj izravnoj provjeri Scryfall od 10. studenoga 2026. ovo je vratilo 161 kandidata, uključujući Abundant Growth. Njegovo izvlačenje karte događa se kada sama Aura uđe. Sadrži obje riječi, ali ne pruža ponovljivi engine za izvlačenje pri ulasku stvorenja koji zahtjev sugerira.

Isprobajte ovu doradu:

Keep the same colors and budget. Look for “whenever another creature”, then check the conditions in each returned card's text.

Uži upit koji smo provjerili bio je:

f:commander id<=g o:"whenever another creature" o:enters o:draw usd<5

Dorađena pretraga vratila je četiri kandidata. Garruk’s Packleader korisno je uvjetno podudaranje: drugo stvorenje mora imati snagu 3 ili veću. Ta razlika pripada preporuci. Strategiji s tokenima i mnogo 1/1 stvorenja možda treba druga karta.

Dodavanje samo o:"another creature" manje je precizno. Naš test i dalje je pronašao Disciple of Freyalise, čiji vlastiti ulazak može dovesti do toga da žrtvujete drugo stvorenje i izvučete kartu. To je još jedan razlog da pregledate cijelu sposobnost umjesto da dodatnu frazu tretirate kao dokaz.

Ponovite istu petlju za vlastiti špil: zahtjev → upit → tekst karte → jedna dorada. Ako budžet ukloni svakog korisnog kandidata, pitajte prije nego što ga proširite. Ako karta ima ograničenje, navedite ograničenje umjesto da ga tiho izostavite iz objašnjenja.

Korak 5: Kako testirati pronalazač karata prije upotrebe?

Testirajte i odgovor i API poziv. Uvjerljiva rečenica ne može potvrditi koji je upit pokrenut ni koji su se zapisi vratili.

1. Otvorite Testing i izradite skup podataka pod nazivom Open Query checks koristeći Create Dataset → Paste messages. Zalijepite neovisne testne poruke iz paketa.
2. Pokrenite testove. Ocijenite prikazuje li odgovor svoj upit, navodi li vraćene karte i objašnjava li nesigurnost.
3. Otvorite odgovarajući razgovor u Inbox i pregledajte Action poziv. Provjerite upit, broj stranice, status i vraćena polja. Upotrijebite kontrolu Actiona View logs za pronalaženje pojedinačnih poziva.
4. Testirajte doradu i paginaciju u nastavku razgovora, gdje je prethodni upit dostupan.

Za test bez podudaranja pošaljite:

Find a Commander card named definitely-not-a-real-card-xyz.

Jedan izravni API test pokazao je zašto su upozorenja važna. Neispravan upit f:commander o:/[/ vratio je HTTP 200, ali Scryfall je prijavio da je zanemario nevaljani izraz. Rezultati su zato bili širi od traženog. Sačuvajte to upozorenje, objasnite zanemareni filtar i ispravite upit prije preporučivanja tih rezultata.

Naša lokalna pokretanja Agenta obuhvatila su osnovni slučaj, doradu, prazne rezultate i pretragu na dvije stranice. Zasebne API provjere obuhvatile su nedostajuće cijene, lica karata i upozorenja sintakse. Za testiranje ograničenja brzine bez slanja prekomjernog prometa koristite kontrolirani fixture.

Dokumentacija endpointa za pretraživanje karata trenutačno navodi dva zahtjeva za pretraživanje u sekundi. Držite razmak između zahtjeva najmanje 500 milisekundi. Ovaj vodič je osobni pomoćnik za pretraživanje. Javni bot koji služi mnogim igračima treba zajedničko ograničavanje brzine i cacheiranje. Traženje od modela da uspori ne provodi globalno ograničenje zahtjeva.

Mogu li ChatGPT ili Claude pomoći pri konfiguraciji ovoga?

Možete koristiti plugin Quickchat AI za ChatGPT ili konektor Quickchat AI za Claude za konfiguriranje Agenta putem veze za upravljanje računom. Sami dovršite prijavu, zatim dostavite ovaj vodič i njegov početni paket uz sljedeći zahtjev:

Use Quickchat AI to create a dedicated Agent called Open Query using the attached tutorial and starter kit. Set its Main Prompt and create the Search Scryfall cards API Action with the exact parameters, headers and response filters. Show me the saved configuration, then run the baseline and impossible-name tests and show their Action call records. Run only those two conversations; they use AI credits. Do not publish the Agent or connect a public channel.

Dokumentacija za upravljanje računom objašnjava vezu. Ovo konfigurira vaš račun Quickchat AI. Ne čini automatski Open Query dostupnim drugim ljudima kao MCP alat.

Često postavljana pitanja

Mogu li pretraživati Scryfall prirodnim jezikom?

AI pomoćnik može prevesti zahtjev napisan običnim jezikom u sintaksu pretraživanja Scryfall i izvršiti ga putem API-ja Scryfall. Ovaj vodič izrađuje tog pomoćnika u Quickchat AI i navodi ga da prikaže upit, povezane zapise o kartama i relevantni Oracle tekst kako biste mogli provjeriti tumačenje.

Trebam li API ključ za Scryfall?

Ne. Javni endpoint za pretraživanje karata ne zahtijeva račun ni API ključ. Pošaljite identifikacijska zaglavlja User-Agent i Accept, poštujte ograničenja brzine servisa Scryfall i dodatne stranice tražite namjerno.

Može li ovaj AI pronalazač karata halucinirati kartu?

Upute ograničavaju preporuke na zapise koje vrati Action, s poveznicama Scryfall. Model ipak može pogriješiti, pa provjerite vraćeni ID i Oracle tekst te testirajte nemoguće ime karte prije nego što se oslonite na pomoćnika.

Koja je razlika između id<=g i id=g na Scryfall?

id<=g uključuje zelene i bezbojne identitete, što je prikladno za pretraživanje unutar boja mono-zelenog commandera. id=g zahtijeva točno zeleni identitet. Identitet boje razlikuje se od boje karte. Za izgradnju špila Commander koristite filtar identiteta.

Jesu li cijene Scryfall zajamčene?

Ne. Polje prices.usd predstavlja podatke pružatelja o cijeni za vraćeni print, a ne ponudu prodavatelja. Može biti null. Filtar usd<5 pretražuje ispod pet američkih dolara. Ne utvrđuje troškove dostave, dostupnost ni najjeftiniji print koji se može kupiti.

Vraća li jedna pretraga svaku odgovarajuću kartu?

Pretraga vraća jednu API stranicu. Odgovor uključuje total_cards, has_more i, kada je relevantno, next_page. Open Query prikazuje do pet preporuka s dohvaćene stranice. Zatražite još s te stranice ili izričito zatražite sljedeću API stranicu. Kratki popis nije potpuni skup rezultata.

Može li ovo izraditi cijeli moj špil Commander?

Ovaj vodič izrađuje pomoćnika za pretraživanje karata. Pomaže pronaći i pregledati kandidate za mjesto u špilu. Ne validira potpuni špil od 100 karata, ne optimizira popis špila i ne zamjenjuje suca za pravila.