{"name":"Birinchi Shop A2A agent","protocol":"A2A (Agent2Agent) 1.0, also 0.3 method names","agent_card":"https://birinchishop.uz/.well-known/agent-card.json","jsonrpc":"https://birinchishop.uz/api/a2a/shop","http_json":"https://birinchishop.uz/api/a2a/shop/rest","usage":"JSON-RPC: {\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"SendMessage\",\"params\":{\"message\":{\"messageId\":\"<uuid>\",\"role\":\"ROLE_USER\",\"parts\":[{\"data\":{\"skill\":\"search_products\",\"arguments\":{\"query\":\"soat\"}}}]}}} with header \"A2A-Version: 1.0\". Plain text parts are handled without AI: product keyword → search, \"#1234\" → product details, \"100500 4567\" → order status.","skills":[{"id":"search_products","name":"Search products","description":"Search the Birinchi Shop catalog (product names are Uzbek/Russian). Returns title, price in UZS, delivery fee, availability, product page url and image. Data part: {\"skill\":\"search_products\",\"arguments\":{\"query\"?: string<=80, \"min_price\"?: int, \"max_price\"?: int, \"sort\"?: \"popular\"|\"newest\"|\"price_asc\"|\"price_desc\", \"limit\"?: 1-50}}. Plain text is treated as a search query.","arguments_schema":{"type":"object","properties":{"query":{"type":"string","maxLength":80,"description":"Keywords, e.g. \"karcher\", \"soat\", \"наушники\". Empty = popular products.","examples":["soat","наушники","karcher"]},"max_price":{"type":"integer","minimum":0,"description":"Maximum product price in UZS.","examples":[300000]},"min_price":{"type":"integer","minimum":0,"description":"Minimum product price in UZS.","examples":[100000]},"sort":{"type":"string","enum":["popular","newest","price_asc","price_desc"],"description":"Result order. Omit for the default (popular first).","default":"popular","examples":["price_asc"]},"limit":{"type":"integer","minimum":1,"maximum":50,"description":"Default 10.","default":10,"examples":[5]}},"additionalProperties":false}},{"id":"get_product","name":"Product details","description":"Full product details: description, images, video, variants (size/color with own price and availability) and the total to pay including delivery. Data part: {\"skill\":\"get_product\",\"arguments\":{\"product_id\": int}}. Text: \"#1234\".","arguments_schema":{"type":"object","properties":{"product_id":{"type":"integer","minimum":1,"description":"Product id from search_products results.","examples":[1234]}},"required":["product_id"],"additionalProperties":false}},{"id":"get_order_status","name":"Order status","description":"Status of an order placed earlier; needs the order id and the last 4 digits of the phone used. Data part: {\"skill\":\"get_order_status\",\"arguments\":{\"order_id\": int, \"phone_last4\": \"dddd\"}}. Text: \"<order_id> <last 4 digits>\". Failed lookups are limited per IP.","arguments_schema":{"type":"object","properties":{"order_id":{"type":"integer","minimum":1,"description":"Order id returned by place_order.","examples":[100500]},"phone_last4":{"type":"string","pattern":"^\\d{4}$","description":"Last 4 digits of the phone number used for the order.","examples":["4567"]}},"required":["order_id","phone_last4"],"additionalProperties":false}},{"id":"store_info","name":"Delivery, payment and returns","description":"Store policies: delivery area, time and fee, cash-on-delivery payment, how orders are confirmed, returns and support contact. Data part: {\"skill\":\"store_info\"}. Text: \"info\".","arguments_schema":{"type":"object","properties":{},"additionalProperties":false}},{"id":"place_order","name":"Place a cash-on-delivery order","description":"Places a REAL cash-on-delivery order for a shopper in Uzbekistan; a call-center operator phones the number to confirm, then a courier delivers and collects cash. Structured data part only: {\"skill\":\"place_order\",\"arguments\":{\"product_id\": int, \"variant_id\"?: int, \"variant_type_id\"?: int, \"customer_name\": string, \"customer_phone\": \"+998XXXXXXXXX\", \"region\": string, \"agent\"?: string, \"customer_confirmed\"?: boolean}}. Without customer_confirmed=true the task returns TASK_STATE_INPUT_REQUIRED with the order summary and total; after the shopper explicitly agrees, send {\"customer_confirmed\": true} to the same taskId. Never place test or invented orders — every order is phoned by a real call center. Limits: 5 orders per hour per connection, one order per phone and product per 24 hours, at most 3 different products per phone per 24 hours.","arguments_schema":{"type":"object","properties":{"product_id":{"type":"integer","minimum":1,"description":"Product id from search_products or get_product.","examples":[1234]},"variant_id":{"type":"integer","minimum":1,"description":"Required if the product has variants; variant ids are listed in the product details.","examples":[56]},"variant_type_id":{"type":"integer","minimum":1,"description":"Required if the chosen variant has types.","examples":[78]},"customer_name":{"type":"string","minLength":2,"maxLength":100,"description":"Shopper's name for the courier, as they gave it.","examples":["Ali Valiyev"]},"customer_phone":{"type":"string","maxLength":20,"description":"Uzbekistan mobile number, +998XXXXXXXXX.","examples":["+998900000000"]},"region":{"type":"string","maxLength":64,"description":"Region (viloyat) or city in Uzbekistan.","examples":["Toshkent","Samarqand viloyati"]},"customer_confirmed":{"type":"boolean","description":"Must be true: the shopper explicitly confirmed this order.","examples":[true]},"agent":{"type":"string","maxLength":60,"description":"Name of the assistant placing the order, e.g. \"ChatGPT\".","examples":["Claude","ChatGPT"]}},"required":["product_id","customer_name","customer_phone","region"],"additionalProperties":false}}],"ordering":"place_order without customer_confirmed=true returns TASK_STATE_INPUT_REQUIRED with a summary; send {\"customer_confirmed\": true} to the same taskId after the shopper explicitly agreed. Every order is phoned by a real call center.","limits":{"body_bytes":65536,"requests_per_minute_per_ip":60,"orders_per_hour_per_ip":5},"not_supported":["streaming (SendStreamingMessage, SubscribeToTask)","push notifications","extended agent card","gRPC","file parts"],"task_storage":"In memory, 1 hour (pending order confirmations 30 minutes); lost on server restart."}