SuperAPI AI Directory

queue-skill

General & other

View repository

Updated 10-16 08:43

About this skill

Store queue number taking

A set of capabilities to complete store search, queue status viewing, online number taking, and queue progress inquiry based on the store list.

Trigger scenarios

Examples of user utterances (routing hits this skill):

  • "Help me find a store where I can take a number"
  • "Which store near Wangjing has the fastest queue"
  • "Help me check what number this store is currently on"
  • "I want to take a number first"
  • "How many people are ahead of me"
  • "Help me check my queue progress"

Out of scope

  • Requests such as drink ordering, specification selection, order placement and payment → not within the scope of this skill, handled by the ordering skill
  • Requests such as map navigation, route planning, and contacting stores by phone → not within the scope of this skill
  • Requests such as historical orders, membership points, and coupons → not within the scope of this skill

API chain

  • searchStores: store search and candidate store list display.
  • getStoreQueueStatus: view the current queue status of a single store.
  • takeQueueNumber: generate a queue ticket after confirming that a number can be taken.
  • getQueueProgress: query the current position and waiting progress based on a real ticket.

Usage order

  • Before taking a number, the specific store must first be determined; when there is no store context, first display the list of selectable stores, then view the current queue status of that store.
  • Before generating a queue ticket, the store's current queue status and number-taking status must first be seen; execute number taking only after confirming that a number can be taken.
  • Before querying queue progress, a valid ticket must first be obtained; when there is no valid ticket, the current position cannot be queried directly.
  • All APIs with bound components should prioritize displaying cards, and should not be changed to plain text expanded item by item.