สร้างตัวค้นหาการ์ด AI Commander ด้วย Scryfall

Piotr Grudzień
เผยแพร่ ใช้เวลาอ่าน 14 นาที
Aggressive Mammoth ข้างคำขอ Commander ที่เขียนด้วยภาษาธรรมดาและคิวรี Scryfall ที่สอดคล้องกัน

ตัวค้นหาการ์ด Scryfall Commander จะเปลี่ยนคำอธิบายการ์ดที่คุณต้องการให้เป็นการค้นหาที่คุณสามารถตรวจดูได้ ในบทช่วยสอนนี้ คุณจะสร้าง Open Query ซึ่งเป็น Agent ของ Quickchat AI ที่แสดงคิวรี Scryfall ของตัวเอง ส่งคืนระเบียนการ์ดจริง และอธิบายว่าทำไมตัวเลือกแต่ละใบจึงอาจเหมาะกับเด็คของคุณ

เริ่มจากหนึ่งช่องในเด็ค Commander สีเขียวล้วน คุณต้องการครีเจอร์ที่มี trample และมีราคาต่ำกว่าห้าดอลลาร์สหรัฐ เมื่อจบบทช่วยสอนนี้ คุณจะสามารถพิมพ์คำขอนั้น เปิดดูการ์ดที่ส่งกลับมา และปรับการค้นหาให้แคบลงได้โดยไม่ต้องจำโอเปอเรเตอร์ทุกตัว

Open Query ที่แสดงคิวรี Scryfall ที่รันจริงและคำแนะนำการ์ด Commander ที่ลิงก์ไว้ เป้าหมายคือคิวรีที่มองเห็นได้และชุดการ์ดจำนวนน้อยที่ลิงก์ไว้ให้คุณตรวจดูได้ เปิดภาพใดก็ได้เพื่อดูภาพขนาดเต็ม

การ์ด Aggressive Mammoth จริง พร้อมอัตลักษณ์สี Scryfall ความถูกกฎหมายใน Commander คีย์เวิร์ด trample และราคา USD การ์ดที่ส่งกลับมาหนึ่งใบซึ่งตรวจสอบเทียบกับระเบียน Scryfall ของการ์ดนั้น พบราคา USD 0.35 เมื่อวันที่ 10 พฤศจิกายน 2026 ภาพการ์ดโดย Filip Burburan, © Wizards of the Coast; รูปภาพจัดหาโดย Scryfall ไม่มีฝ่ายใดรับรองบทช่วยสอนนี้

ส่วนที่มีประโยชน์จริงจะเริ่มขึ้นเมื่อคำขอยากขึ้น “Draw when another creature enters” ฟังดูเฉพาะเจาะจง แต่การค้นหาคำว่า enters และ draw ก็ยังอาจพบการ์ดที่ทำอย่างอื่นได้ คุณจะ จับความไม่ตรงกันนั้นและทำให้คิวรีแคบลง โดยใช้ข้อความการ์ดที่ส่งกลับมาเป็นหลักฐาน

คุณจะสร้างอะไร และต้องใช้อะไรบ้าง

คุณจะเชื่อมต่อ API Action แบบอ่านอย่างเดียวหนึ่งตัวเข้ากับ Scryfall ใส่คำสั่งการค้นหาให้ Agent และทดสอบ Agent ในการสนทนา Action จะเรียก URL แบบคงที่ ส่วนโมเดลจะเป็นผู้ส่งคิวรีและหมายเลขหน้า Scryfall จะส่งคืนระเบียนที่คำตอบใช้อ้างอิง

โมเดลส่งคิวรี, API Action แบบคงที่ดึงระเบียน Scryfall และผู้อ่านตรวจสอบข้อความการ์ด โมเดลตีความคำขอของคุณ Action ดึงระเบียนมาให้ คุณตรวจสอบว่าข้อความที่ส่งกลับมารองรับการตีความนั้นหรือไม่

  1. สร้างบัญชี Quickchat AI และสร้าง Agent ชื่อ Open Query คุณต้องมีเครดิต AI ที่พร้อมใช้งานสำหรับการสนทนาและการทดสอบ ดูรายละเอียดได้ที่แพ็กเกจปัจจุบัน
  2. เตรียม Identity, Actions & MCPs และ AI Preview ของ Agent ไว้ให้พร้อมระหว่างทำงาน คุณไม่จำเป็นต้องอัปโหลดคอลเลกชันการ์ดใด ๆ
  3. ใช้ API สาธารณะของ Scryfall คุณไม่จำเป็นต้องมีบัญชีหรือคีย์ API ของ Scryfall สำหรับการค้นหาเหล่านี้

starter kit มี Main Prompt สูตร Action พาธ response-filter และข้อความทดสอบ ตัวอย่างทั้งหมดใช้ข้อความ Oracle ภาษาอังกฤษและราคา USD เมื่อคุณทำตามบทช่วยสอนนี้ในภาษาอื่น ให้คงโอเปอเรเตอร์ของคิวรีและชื่อการ์ดไว้ตามที่เขียนไว้

ขั้นตอนที่ 1: คุณจะเปลี่ยนคำขอการ์ดให้เป็นคิวรี Scryfall ได้อย่างไร

คิวรี Scryfall จะรวมเงื่อนไขหลายข้อที่คั่นด้วยช่องว่าง สำหรับคำขอแรกของเรา ให้ใช้:

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

ห้าองค์ประกอบของการค้นหา Commander พร้อมคำอธิบายเรื่องรูปแบบ อัตลักษณ์สี ประเภทการ์ด คีย์เวิร์ด และงบประมาณ USD แต่ละองค์ประกอบตอบโจทย์หนึ่งส่วนของคำขอ คุณสามารถเปลี่ยนองค์ประกอบหนึ่งได้โดยไม่ต้องเขียนองค์ประกอบอื่นใหม่

ส่วนของคิวรีสิ่งที่มันค้นหา
f:commanderการ์ดที่ถูกกฎหมายใน Commander
id<=gอัตลักษณ์สีที่อยู่ภายในสีเขียว รวมถึงไร้สี
t:creatureการ์ดครีเจอร์
kw:trampleคีย์เวิร์ด trample
usd<5ราคา USD ของ Scryfall ที่ต่ำกว่า 5

มีตัวเลือกเล็ก ๆ สองจุดที่สำคัญ kw:trample ใช้ค้นหาคีย์เวิร์ด ส่วน o:trample ใช้ค้นหาคำนั้นในข้อความ Oracle ครีเจอร์อาจกล่าวถึง trample โดยที่ตัวมันเองไม่ได้มีความสามารถนั้น เราทดสอบทั้งสองแบบแล้ว และการค้นหาจากข้อความให้ชุดผลลัพธ์ที่กว้างกว่า

“ใส่ในเด็คสีเขียวล้วนได้” ก็แตกต่างจาก “มีอัตลักษณ์สีเขียวเท่านั้น” เช่นกัน แบบแรกอนุญาตให้มีการ์ดไร้สี ใช้ id=g สำหรับความหมายแบบหลัง หรือใช้ id<=ur เพื่อค้นหาภายในสีของผู้บัญชาการน้ำเงินแดง สิ่งเหล่านี้เป็นข้อจำกัดด้านอัตลักษณ์สี ไม่ใช่การตรวจสอบความถูกกฎหมายของเด็คแบบครบถ้วน

Aggressive Mammoth และ Eldrazi Devastator แสดงว่าอัตลักษณ์สีใดตรงกับ id<=g และ id=g ทั้งสองการ์ดตรงกับ id<=g แต่มีเพียง Aggressive Mammoth ที่มีอัตลักษณ์เป็นสีเขียวเพียงสีเดียวตาม id=g

เอกสารอ้างอิงไวยากรณ์การค้นหา ของ Scryfall อธิบายโอเปอเรเตอร์เหล่านี้ สำหรับบทช่วยสอนนี้ ให้แสดงคิวรีไว้ในทุกคำตอบ เพื่อให้คุณสังเกตเห็นได้เมื่อมีสีที่หายไป มีสกุลเงินที่ไม่คาดคิด หรือมีการค้นหาที่กว้างกว่าคำขอของคุณ

ขั้นตอนที่ 2: คุณจะเชื่อม API ของ Scryfall เข้ากับ Agent ของคุณอย่างไร

สร้าง API Action หนึ่งตัวที่ส่งคำขอ GET ไปยังเอ็นด์พอยต์ค้นหาการ์ดของ Scryfall การตั้งค่าแบบคงที่จะเลือกผู้ให้บริการและลำดับการเรียง ส่วนพารามิเตอร์สองตัวจะให้ Agent เลือกการค้นหาและหมายเลขหน้าได้

  1. เปิด Actions & MCPs → Add Action → API Action
  2. ใช้คำขอสำหรับตัวสร้างด้านล่าง จากนั้นตรวจทานการตั้งค่าที่สร้างขึ้นเทียบกับสูตร คู่มือตัวสร้าง API Action อธิบายขั้นตอนการสร้างและการตรวจทาน
  3. ตั้งค่า API Action Name เป็น 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.

กำหนดพารามิเตอร์สองตัว

ภายใต้ What to ask the user first ให้เพิ่มพารามิเตอร์ที่จำเป็นดังต่อไปนี้ Agent สามารถกรอกค่าพารามิเตอร์เหล่านี้จากบทสนทนาได้ ป้ายกำกับนี้ไม่ได้หมายความว่า Agent จะต้องขอให้คุณพิมพ์ไวยากรณ์คิวรีดิบด้วยตัวเอง

รูปแบบชื่อคำอธิบายจำเป็น
Textqueryคิวรี Scryfall ที่สะท้อนรูปแบบ อัตลักษณ์สี ประเภทการ์ด ความสามารถ และตัวกรองสกุลเงินแบบเลือกได้ที่ได้รับการยืนยันแล้ว ให้ใช้ไวยากรณ์ที่มีเอกสารรองรับYes
Numberpageหมายเลขหน้า API โดยเริ่มที่ 1 ให้เพิ่มขึ้นเฉพาะเมื่อผู้อ่านขอหน้าถัดไปของคิวรีเดิมอย่างชัดเจนYes

ตัวแก้ไข Action ของ Search Scryfall cards จริง พร้อมพารามิเตอร์ query และ page พารามิเตอร์สองตัวนี้คือค่าที่เปลี่ยนไปในแต่ละครั้งที่ค้นหา

ตั้งค่าเอ็นด์พอยต์ พารามิเตอร์คิวรี และส่วนหัว

เลือก GET แล้วกรอก:

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

ภายใต้ Query Params ให้เพิ่มสี่แถวด้านล่าง สำหรับค่าแบบไดนามิก ให้ใช้ Add AI Data เพื่อเลือกพารามิเตอร์ที่คุณสร้างไว้ สัญลักษณ์ {{query}} และ {{page}} ด้านล่างใช้แทนชิปพารามิเตอร์เหล่านั้น

พารามิเตอร์คิวรีค่า
q{{query}}
uniquecards
ordername
page{{page}}

เอ็นด์พอยต์ API ของ Scryfall และแถว Query Params ที่มี query และ page แทรกเป็นชิปพารามิเตอร์ เอ็นด์พอยต์คงที่ ส่วนชิปจะส่งค่า query และ page สำหรับการเรียกแต่ละครั้ง

ให้ใช้ช่องพารามิเตอร์คิวรี เพื่อให้ช่องว่าง เครื่องหมายอัญประกาศ และโอเปอเรเตอร์ต่าง ๆ ถูกเข้ารหัสเป็นค่าพารามิเตอร์ คง URL ของเอ็นด์พอยต์ไว้แบบคงที่

ส่วนหัวค่า
Acceptapplication/json
User-AgentQuickchatTutorialCardFinder/1.0 (+https://quickchat.ai)

ปล่อย Body ว่างไว้ ไม่จำเป็นต้องมีการยืนยันตัวตน User-Agent เป็นชื่อไคลเอนต์สำหรับระบุตัวตน ไม่ใช่ข้อมูลรับรอง เมื่อคุณนำเวอร์ชันของคุณไปใช้งานจริง ให้ใช้ชื่อแอปพลิเคชันและ URL สำหรับการติดต่อของคุณเองที่เหมาะสม

ทำให้คำตอบยังมีประโยชน์

หน้า Scryfall หนึ่งหน้าอาจมีหลายระเบียน ให้เก็บเฉพาะฟิลด์ที่ Agent ต้องใช้ พร้อมทั้งข้อมูลที่บอก Agent ว่ายังมีหน้าเพิ่มเติมหรือไม่ ขยาย Advanced settings แล้วหา Response filter ใช้ Add JSONPath แล้วกดปุ่มบวก เพื่อเพิ่มแต่ละพาธด้านล่างเป็นรายการแยกกัน:

$.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

รายการ Response filter สำหรับ total_cards, has_more, next_page และ warnings ในตัวแก้ไข Action ให้เก็บทั้งเมทาดาทาของรายการและข้อมูลการ์ด คำตอบที่ถูกกรองแล้วก็ควรยังอธิบายขอบเขตของมันได้

การ์ด Aberrant Manawurm จริง พร้อมฟิลด์ที่ส่งกลับสำหรับอัตลักษณ์สี การใช้ได้ใน Commander ราคา USD และข้อความ Oracle ฟิลด์ที่เลือกไว้เบื้องหลังคำแนะนำหนึ่งรายการ ราคา USD 0.17 เป็นค่าที่สังเกตเมื่อวันที่ 10 พฤศจิกายน 2026 โดยเรคอร์ดเต็มยังมี ID และลิงก์ Scryfall ด้วย

ให้เก็บ card_faces ไว้ การ์ดบางใบเก็บข้อความไว้บนแต่ละหน้าแทนที่จะอยู่ในระดับบนสุด และให้เก็บ warnings ไว้ด้วย เพราะการที่ HTTP สำเร็จไม่ได้หมายความว่า Scryfall ตีความทุกองค์ประกอบของคิวรีตรงตามที่ตั้งใจ เอกสารอ้างอิง Card object อธิบายฟิลด์เหล่านี้

ใน API Action Description ให้วาง:

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.

บันทึก Action แล้วตรวจสอบว่า Action เปิดใช้งานอยู่ คู่มือโครงสร้าง HTTP Action อธิบายว่าพารามิเตอร์ คำขอ และคำอธิบายทำงานร่วมกันอย่างไร

ขั้นตอนที่ 3: ตัวค้นหาการ์ดควรอธิบายผลลัพธ์อย่างไร

Agent ต้องมีคำสั่งที่บอกให้แสดงคิวรีของตัวเอง ยึดคำแนะนำไว้กับระเบียนที่ส่งกลับมา และแยกความแตกต่างระหว่างการตรงกันของคำกับปฏิสัมพันธ์ตามกฎ เปิด Identity → Main Prompt แล้ววางพรอมป์ฉบับเต็มจาก starter kit ซึ่งแสดงซ้ำไว้ด้านล่าง

คัดลอก Main Prompt ฉบับเต็ม
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.

ช่อง Main Prompt ของ Open Query ในการตั้งค่า Identity คำสั่งนี้ใช้ทั้งกับการค้นหาและกับคำอธิบายหลังจากได้รับคำตอบกลับมาแล้ว

ตอนนี้เปิด AI Preview แล้วส่ง:

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

เดโมนี้ตีความความสามารถในการใส่ลงในเด็คสีเขียวล้วนว่าเป็นการ์ดสีเขียวหรือไร้สี หากคุณต้องการอัตลักษณ์สีเขียวเท่านั้น ให้ระบุอย่างชัดเจน

อ่านคิวรีที่รันจริงก่อนดูคำแนะนำ คิวรีนั้นควรคง Commander อัตลักษณ์สีเขียวหรือไร้สี ประเภทครีเจอร์ trample และราคา USD ต่ำกว่า 5 ไว้ เปิดลิงก์ Scryfall ของการ์ดหนึ่งใบ แล้วเปรียบเทียบข้อความที่เกี่ยวข้อง อัตลักษณ์สี และราคากับคำตอบ ราคานั้นเป็นข้อมูลที่สังเกตได้จากการค้นหาของฉบับพิมพ์ที่ส่งกลับมา ไม่ใช่ราคาเสนอสำหรับการชำระเงินจริง

ผลลัพธ์จาก API เรียงตามชื่อ ไม่ได้จัดอันดับตามความเหมาะสม Agent จะเลือกทำรายการสั้นจากหน้าที่ดึงมา unique=cards ช่วยหลีกเลี่ยงการแสดงทุกฉบับพิมพ์เป็นผลลัพธ์แยกกัน แต่ไม่ได้หมายความว่าระเบียนที่เลือกคือสำเนาที่ถูกที่สุดที่คุณสามารถซื้อได้

เปรียบเทียบการ์ด Aberrant Manawurm และ Aggressive Mammoth: ทั้งคู่มี trample แต่ความสามารถอื่นสนับสนุนแผนการเล่นต่างกัน ทั้งคู่ผ่านเงื่อนไขการค้นหาเดียวกัน Aberrant Manawurm ให้ประโยชน์จากการร่ายเวทอินสแตนต์และซอร์เซอรี ส่วน Aggressive Mammoth มอบ trample ให้ครีเจอร์ตัวอื่นของคุณ อ่านส่วนที่เหลือของความสามารถก่อนเลือก

ขั้นตอนที่ 4: คุณจะแก้การค้นหาที่พบปฏิสัมพันธ์ผิดได้อย่างไร

ทำให้คิวรีแคบลงโดยอ่านตัวอย่างโต้แย้งหนึ่งใบ แล้วเพิ่มเงื่อนไขที่ขาดไป ระหว่างการปรับแต่ง ให้รักษาความแตกต่างระหว่างการค้นหาการ์ดตัวเลือกกับการยืนยันข้อความของการ์ดเหล่านั้นไว้ตลอด

ถามว่า:

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

การค้นหาตัวเลือกแบบกว้างคือ:

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

ในการตรวจสอบ Scryfall โดยตรงของเราเมื่อวันที่ 10 พฤศจิกายน 2026 การค้นหานี้คืนตัวเลือก 161 ใบ รวมถึง Abundant Growth การจั่วของการ์ดใบนี้เกิดขึ้นเมื่อ Aura ใบนั้นเองเข้ามา มันมีทั้งสองคำจริง แต่ไม่ได้ให้เอนจินการจั่วซ้ำได้จากการเข้ามาของครีเจอร์ตามที่คำขอบอกเป็นนัย

การ์ด Abundant Growth และ Garruk's Packleader จริง พร้อมการเปรียบเทียบเงื่อนไขที่ทำให้เกิดการจั่วต่างกัน ให้อ่านให้ชัดว่าอะไรเป็นสาเหตุให้เกิดการจั่ว การตรงกันของสองคำไม่ได้ยืนยันว่าปฏิสัมพันธ์นั้นมีอยู่จริง

ลองปรับแต่งแบบนี้:

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

คิวรีที่แคบลงซึ่งเราตรวจสอบคือ:

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

การค้นหาที่ปรับแล้วคืนตัวเลือกสี่ใบ Garruk’s Packleader เป็นการตรงกันแบบมีเงื่อนไขที่ใช้ได้ ครีเจอร์อีกตัวต้องมีพลัง 3 หรือมากกว่า ความแตกต่างนี้ควรถูกระบุไว้ในคำแนะนำ กลยุทธ์โทเคนที่มีครีเจอร์ 1/1 จำนวนมากอาจต้องใช้การ์ดอีกใบ

Garruk's Packleader: พลัง 3 ขึ้นไปและเลือกจั่วได้; Gladewalker Ritualist: ครีเจอร์อีกตัวที่คุณควบคุมและมีชื่อเดียวกัน; Outcaster Trailblazer: พลัง 4 ขึ้นไป; Selvala: ผู้ควบคุมครีเจอร์ที่เข้ามาอาจจั่วได้ หากพลังของมันมากกว่าครีเจอร์ตัวอื่นทุกตัวขณะแก้ผลความสามารถ ตัวเลือกทั้งสี่ที่ส่งกลับมามีเงื่อนไขต่างกัน ตรวจสอบพลัง ชื่อการ์ด และผู้ที่ได้จั่วก่อนตัดสินว่าการ์ดใดเหมาะกับสิ่งที่ต้องการ

การเพิ่มเพียง o:"another creature" ยังไม่แม่นพอ การทดสอบของเรายังพบ Disciple of Freyalise ซึ่งการเข้ามาของตัวมันเองอาจทำให้คุณสังเวยครีเจอร์อีกตัวแล้วจั่ว นี่เป็นอีกเหตุผลหนึ่งที่คุณควรตรวจดูความสามารถทั้งหมด แทนที่จะถือว่าวลีเพิ่มเติมเพียงอย่างเดียวเป็นหลักฐานยืนยัน

ทำลูปเดิมซ้ำกับเด็คของคุณเอง: คำขอ → คิวรี → ข้อความการ์ด → การปรับแต่งหนึ่งครั้ง หากงบประมาณตัดตัวเลือกที่มีประโยชน์ออกไปทั้งหมด ให้ถามก่อนว่าจะขยายงบประมาณหรือไม่ หากการ์ดมีข้อจำกัด ให้ระบุข้อจำกัดนั้น แทนที่จะตัดข้อจำกัดออกจากคำอธิบายอย่างเงียบ ๆ

ขั้นตอนที่ 5: คุณจะทดสอบตัวค้นหาการ์ดก่อนใช้งานได้อย่างไร

ให้ทดสอบทั้งคำตอบและการเรียก API เพราะประโยคที่ฟังน่าเชื่อถือเพียงอย่างเดียวไม่สามารถยืนยันได้ว่ามีการรันคิวรีใด หรือมีระเบียนใดถูกส่งกลับมาบ้าง

  1. เปิด Testing แล้วสร้างชุดข้อมูลชื่อ Open Query checks โดยใช้ Create Dataset → Paste messages จากนั้นวางข้อความทดสอบแบบอิสระจากชุดเครื่องมือ
  2. รันทดสอบ แล้วให้คะแนนว่าคำตอบแสดงคิวรีของตัวเอง อ้างถึงการ์ดที่ส่งกลับมา และอธิบายความไม่แน่นอนได้หรือไม่
  3. เปิดบทสนทนาที่ตรงกันใน Inbox แล้วตรวจดูการเรียก Action ตรวจสอบคิวรี หมายเลขหน้า สถานะ และฟิลด์ที่ส่งกลับมา ใช้ตัวควบคุม View logs ของ Action เพื่อค้นหาการเรียกแต่ละครั้ง
  4. ทดสอบการปรับแต่งและการแบ่งหน้าในบทสนทนาต่อเนื่อง ซึ่งมีคิวรีก่อนหน้าให้ใช้อ้างอิง

ชุดข้อมูล Open Query checks ในพื้นที่ Testing ใช้ข้อความแบบอิสระสำหรับการตรวจสอบแยกกัน และใช้บทสนทนาต่อเนื่องสำหรับการปรับแต่ง

การเรียก Action ของ Scryfall ที่ถูกบันทึกไว้ พร้อมคิวรีที่รันจริง หมายเลขหน้า และฟิลด์การแบ่งหน้าที่ส่งกลับมา ให้ตรวจดูคำขอและคำตอบควบคู่กัน สถานะ HTTP ที่สำเร็จเพียงอย่างเดียวไม่ได้ยืนยันคำแนะนำการ์ด

กรณีทดสอบสิ่งที่ต้องตรวจดู
First trample requestคิวรีที่ถูกต้อง หน้า 1 การ์ดจริงที่ลิงก์ไว้ และหลักฐานคีย์เวิร์ดหรือข้อความที่เกี่ยวข้อง
Another-creature draw requestเงื่อนไขอย่างพลัง 3 หรือมากกว่ายังคงอยู่ในคำตอบ
“Show the next API page.”คิวรีเดิมและหน้า 2 เฉพาะเมื่อ has_more เป็นจริง
“Show more from this page.”ขอคำค้นและหน้าเดิมอีกครั้ง แล้วแสดงการ์ดที่ยังไม่เคยแสดง
Impossible card nameไม่มีการสร้างตัวแทนขึ้นมาเอง ให้อธิบายผลลัพธ์ว่างและเสนอการเปลี่ยนแปลงที่เฉพาะเจาะจง
Missing USD fieldราคาไม่ทราบค่า ห้ามตีความเป็นศูนย์หรือ “free”
Malformed query or provider warningให้อธิบายปัญหาและถามก่อนจะขยายคิวรี
Rate-limit responseให้หยุด แทนที่จะลองใหม่ซ้ำ ๆ

สำหรับการทดสอบแบบไม่พบผลลัพธ์ ให้ส่ง:

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

คำตอบแบบไม่พบผลลัพธ์จริงจากเดโม Open Query ผลลัพธ์ว่างเป็นคำตอบที่มีประโยชน์ มันให้คิวรีที่คุณสามารถนำไปแก้ไขต่อได้โดยไม่ต้องมโนการ์ดขึ้นมา

การทดสอบ API โดยตรงครั้งหนึ่งของเราแสดงให้เห็นว่าทำไมคำเตือนจึงสำคัญ คิวรีที่ผิดรูปแบบ f:commander o:/[/ คืน HTTP 200 แต่ Scryfall รายงานว่าระบบเพิกเฉยนิพจน์ที่ไม่ถูกต้องนั้น ดังนั้นผลลัพธ์จึงกว้างกว่าที่ร้องขอไว้ คุณควรเก็บคำเตือนนั้นไว้ อธิบายตัวกรองที่ถูกเพิกเฉย และแก้คิวรีให้ถูกต้องก่อนจะแนะนำผลลัพธ์เหล่านั้น

การรัน Agent ในเครื่องของเราครอบคลุมกรณีพื้นฐาน การปรับแต่ง ผลลัพธ์ว่าง และการค้นหาสองหน้า ส่วนการตรวจสอบ API แยกต่างหากครอบคลุมราคาที่หายไป หน้าไพ่ และคำเตือนไวยากรณ์ ให้ใช้ฟิกซ์เจอร์ที่ควบคุมได้เพื่อทดสอบการจำกัดอัตราโดยไม่ส่งทราฟฟิกเกินจำเป็น

เอกสารเอ็นด์พอยต์ค้นหาการ์ด ปัจจุบันระบุว่า คำขอค้นหาได้สองครั้งต่อวินาที ให้เว้นระยะคำขออย่างน้อย 500 มิลลิวินาที บทช่วยสอนนี้เป็นผู้ช่วยค้นหาส่วนตัว แต่บอตสาธารณะที่ให้บริการผู้เล่นจำนวนมากจำเป็นต้องมีการจำกัดอัตราแบบใช้ร่วมกันและการแคช การบอกให้โมเดลช้าลงไม่ได้บังคับใช้ขีดจำกัดคำขอแบบรวมทั้งหมด

ChatGPT หรือ Claude สามารถช่วยตั้งค่านี้ได้ไหม

คุณสามารถใช้ปลั๊กอิน Quickchat AI สำหรับ ChatGPT หรือตัวเชื่อมต่อ Quickchat AI สำหรับ Claude เพื่อตั้งค่า Agent ผ่านการเชื่อมต่อจัดการบัญชี ให้คุณลงชื่อเข้าใช้ด้วยตัวเองให้เสร็จก่อน แล้วจึงส่งบทช่วยสอนนี้และ starter kit พร้อมคำขอต่อไปนี้:

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.

เอกสารการจัดการบัญชี อธิบายการเชื่อมต่อนี้ การดำเนินการนี้จะตั้งค่าบัญชี Quickchat AI ของคุณ แต่จะไม่ทำให้ Open Query พร้อมใช้งานแก่ผู้อื่นโดยอัตโนมัติในฐานะเครื่องมือ MCP

คำถามที่พบบ่อย

ฉันสามารถค้นหา Scryfall ด้วยภาษาธรรมชาติได้ไหม

ผู้ช่วย AI สามารถแปลคำขอที่เขียนด้วยภาษาธรรมดาให้เป็นไวยากรณ์การค้นหา Scryfall และเรียกใช้งานผ่าน API ของ Scryfall ได้ บทช่วยสอนนี้จะสร้างผู้ช่วยนั้นใน Quickchat AI และทำให้ผู้ช่วยแสดงคิวรี ระเบียนการ์ดที่ลิงก์ไว้ และข้อความ Oracle ที่เกี่ยวข้อง เพื่อให้คุณตรวจสอบได้ว่าผู้ช่วยตีความคำขออย่างไร

ฉันจำเป็นต้องมีคีย์ API ของ Scryfall หรือไม่

ไม่จำเป็น เอ็นด์พอยต์ค้นหาการ์ดสาธารณะไม่ต้องใช้บัญชีหรือคีย์ API ให้ส่งส่วนหัว User-Agent และ Accept ที่ใช้ระบุตัวตน ปฏิบัติตามข้อจำกัดอัตราการใช้งานของ Scryfall และขอหน้าผลลัพธ์เพิ่มเติมอย่างตั้งใจเมื่อจำเป็น

ตัวค้นหาการ์ด AI นี้สามารถมโนการ์ดขึ้นมาเองได้ไหม

คำสั่งจะจำกัดคำแนะนำไว้เฉพาะระเบียนที่ Action ส่งกลับมา พร้อมลิงก์ Scryfall โมเดลยังคงทำผิดพลาดได้ ดังนั้นให้ตรวจสอบ ID และข้อความ Oracle ที่ส่งกลับมา และทดสอบด้วยชื่อการ์ดที่เป็นไปไม่ได้ก่อนที่คุณจะพึ่งพาผู้ช่วยนี้

id<=g กับ id=g บน Scryfall ต่างกันอย่างไร

id<=g รวมทั้งอัตลักษณ์สีเขียวและไร้สี จึงเหมาะสำหรับการค้นหาภายในสีของผู้บัญชาการสีเขียวล้วน ส่วน id=g กำหนดให้ต้องมีอัตลักษณ์เป็นสีเขียวเท่านั้น อัตลักษณ์สีแตกต่างจากสีของการ์ด ดังนั้นสำหรับการสร้างเด็ค Commander ให้ใช้ตัวกรองอัตลักษณ์สี

ราคาของ Scryfall รับประกันหรือไม่

ไม่รับประกัน ฟิลด์ prices.usd เป็นข้อมูลราคาจากผู้ให้บริการสำหรับฉบับพิมพ์ที่ส่งกลับมา ไม่ใช่ข้อเสนอขายจากผู้ขาย และค่าอาจเป็น null ได้ ตัวกรอง usd<5 ใช้ค้นหาการ์ดที่มีราคาต่ำกว่าห้าดอลลาร์สหรัฐ แต่ไม่ได้ยืนยันค่าจัดส่ง ความพร้อมจำหน่าย หรือฉบับพิมพ์ที่ซื้อได้ถูกที่สุด

การค้นหาหนึ่งครั้งจะคืนการ์ดที่ตรงเงื่อนไขทั้งหมดหรือไม่

การค้นหาหนึ่งครั้งจะคืนผลลัพธ์มาเพียงหนึ่งหน้า API คำตอบจะมี total_cards, has_more และเมื่อเกี่ยวข้องก็จะมี next_page ด้วย Open Query จะแสดงคำแนะนำได้สูงสุดห้าใบจากหน้าที่ดึงมา คุณสามารถขอเพิ่มจากหน้านั้น หรือขอหน้าถัดไปของ API อย่างชัดเจนได้ รายการสั้น ๆ ไม่ใช่ชุดผลลัพธ์ทั้งหมด

สิ่งนี้สามารถสร้างเด็ค Commander ทั้งเด็คให้ฉันได้ไหม

บทช่วยสอนนี้สร้างผู้ช่วยค้นหาการ์ด ผู้ช่วยนี้ช่วยค้นหาและตรวจดูตัวเลือกที่เหมาะกับช่องการ์ดหนึ่งช่องในเด็ค แต่ไม่ได้ตรวจสอบเด็ค 100 ใบทั้งเด็ค ไม่ได้ปรับเด็กลิสต์ให้เหมาะที่สุด และไม่ได้แทนกรรมการตัดสินกฎ

Quickchat AI Quickchat AI Ask Quickchat AI a question