การขอค่า RPM สูงสุดของ Agent

รับค่า RPM สูงสุด (จำนวนคำขอต่อหนึ่งนาที) ของ Agent ใด ๆ ตามช่วงเวลา พร้อมทั้งส่งคืนเวลาที่เกิดค่าสูงสุด ค่าเฉลี่ย RPM และจำนวนคำขอทั้งหมด

หมายเหตุ: สามารถขอข้อมูลได้สูงสุด 31 วัน; คำนวณเฉพาะช่องทางของพื้นที่พัฒนา ขอบเขตการสถิติอยู่ด้านล่าง "ขอบเขตการสถิติ"

วิธีการขอ

GET

ที่อยู่ในการเรียก

https://api-${endpoint}.gptbots.ai/v1/org/agent/stat/rpm

การตรวจสอบการเรียก

ใช้ Basic Authentication ด้วย DevKey / DevSecret ระดับบัญชี: Authorization: Basic ${BASIC_TOKEN} โดยที่ ${BASIC_TOKEN} เป็นการเข้ารหัส Base64 ของ DevKey:DevSecret

บัญชีที่เรียกต้องเป็นสมาชิกขององค์กรที่สอดคล้องกับ org_id และมีสิทธิ์ "ดูข้อมูลการใช้งาน" (Owner หรือผู้ดูแลขององค์กรจะมีสิทธิ์โดยค่าเริ่มต้น) และสามารถดู Agent นั้นได้: ผู้สร้าง Agent, Owner ขององค์กร หรือสมาชิกที่ได้สิทธิ์สำหรับ Agent นั้น (หรือทุก Agent)
กรุณาเรียกจากศูนย์ข้อมูลขององค์กร ${endpoint} นำจาก รายการองค์กร ซึ่งให้ค่า region (SG → sg, TH → th, JP → jp). หากเรียกจากศูนย์ข้อมูลอื่น ระบบจะแจ้ง "ไม่ใช่สมาชิกขององค์กรนี้"

ความถี่ในการเรียก

DevKey แต่ละตัวสามารถเรียก API นี้ได้สูงสุด 60 ครั้งต่อหนึ่งนาที
แต่ละครั้งที่เรียกจะถูกนับรวมในการใช้โควต้าต่อหนึ่งนาทีของ "API การสถิติ" ขององค์กร และใช้ร่วมกับคีย์ API ของ Agent สำหรับ API การสถิติ
ข้อมูลจะอัปเดตทุกชั่วโมง การค้นหาเดียวกันภายในชั่วโมงเดียวกันจะได้ผลลัพธ์เดียวกัน แนะนำให้เรียกทุก ๆ ชั่วโมง

คำขอ

ตัวอย่างคำขอ

curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/org/agent/stat/rpm?org_id=${org_id}&agent_id=${agent_id}&start_time=1788192000000&end_time=1788796800000' \ -H 'Authorization: Basic ${BASIC_TOKEN}'

                      
                      curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/org/agent/stat/rpm?org_id=${org_id}&agent_id=${agent_id}&start_time=1788192000000&end_time=1788796800000' \
  -H 'Authorization: Basic ${BASIC_TOKEN}'

บล็อกโค้ดนี้ในหน้าต่างลอย

ส่วนหัวของคำขอ

ฟิลด์	ประเภท	คำอธิบาย
Authorization	Basic ${BASIC_TOKEN}	ใช้ `DevKey:DevSecret` Token แบบ Base64 ของ Basic

พารามิเตอร์ของคำขอ

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
org_id	String	ใช่	รหัสองค์กร
agent_id	String	ใช่	รหัส Agent ไม่รองรับ Workflow
start_time	Long	ใช่	เวลาเริ่มต้น เป็น timestamp มิลลิวินาที ปัดลงไปยังชั่วโมงที่สมบูรณ์
end_time	Long	ใช่	เวลาสิ้นสุด (ไม่รวม) เป็น timestamp มิลลิวินาที ปัดขึ้นไปยังชั่วโมงที่สมบูรณ์ ช่วงเวลาที่ปรับแล้วต้องไม่เกิน 31 วัน
conversation_type	String	ไม่	เฉพาะช่องทางใดช่องทางหนึ่ง เช่น `API`, `SHARE`, `EMBED`, `WIDGET`, `LIVEDESK` ต้องเป็นช่องทางของพื้นที่นักพัฒนาเท่านั้น หากไม่ระบุจะนับรวมทุกช่องทางของพื้นที่นักพัฒนา

การตอบสนอง

ตัวอย่างการตอบสนอง

{ "code": 0, "message": "OK", "data": { "agent_id": "65f0c2a1b4e8d93a1c7e5b21", "range_start": 1788192000000, "range_end": 1788796800000, "data_until": 1788793200000, "peak_rpm": 42, "peak_at": 1788512460000, "avg_rpm": 3.18, "total_requests": 18234 } }

                      
                      {
    "code": 0,
    "message": "OK",
    "data": {
        "agent_id": "65f0c2a1b4e8d93a1c7e5b21",
        "range_start": 1788192000000,
        "range_end": 1788796800000,
        "data_until": 1788793200000,
        "peak_rpm": 42,
        "peak_at": 1788512460000,
        "avg_rpm": 3.18,
        "total_requests": 18234
    }
}

บล็อกโค้ดนี้ในหน้าต่างลอย

การตอบกลับสำเร็จ

ฟิลด์	ประเภท	คำอธิบาย
agent_id	String	ID ของตัวแทน (Agent ID)
range_start	Long	จุดเริ่มต้นของช่วงเวลาสถิติจริง: `start_time` ปรับลงให้ตรงกับชั่วโมงเต็มในรูปแบบเวลามิลลิวินาที
range_end	Long	จุดสิ้นสุดของช่วงเวลาสถิติจริง (ไม่รวม): `end_time` ปรับขึ้นให้ตรงกับชั่วโมงเต็มในรูปแบบเวลามิลลิวินาที
data_until	Long	เวลาที่ข้อมูลถูกรวบรวมถึง (เวลามิลลิวินาที) ส่วนที่อยู่หลังจากเวลานี้ในช่วงยังไม่มีข้อมูล
peak_rpm	Long	RPM สูงสุด: จำนวนคำขอสูงสุดในหนึ่งนาทีภายในช่วงเวลาที่คำนวณจากการรวมคำขอของแต่ละช่องทาง
peak_at	Long	จุดเริ่มต้นของนาทีที่มีค่า RPM สูงสุด (เวลามิลลิวินาที); หากมีหลายวันเวลาเท่ากันให้เลือกนาทีแรก; หากไม่มีคำขอภายในช่วงเป็น `null`
avg_rpm	Number	ค่า RPM เฉลี่ย: จำนวนคำขอทั้งหมด ÷ จำนวนของนาทีที่มีคำขอ, แสดงผล 2 หลักทศนิยม
total_requests	Long	จำนวนคำขอทั้งหมดภายในช่วงเวลานั้น

การตอบกลับล้มเหลว

ฟิลด์	ประเภท	คำอธิบาย
code	Integer	รหัสข้อผิดพลาด
message	String	รายละเอียดข้อผิดพลาด

รหัสข้อผิดพลาด

รหัสสถานะ HTTP คือเลขสามหลักแรกของรหัสข้อผิดพลาด เช่น 40000 ตรงกับ 400, 40100 ตรงกับ 401, 403132 ตรงกับ 403

รหัสข้อผิดพลาด	คำอธิบาย
40000	ข้อผิดพลาดของพารามิเตอร์ เช่น ขาดพารามิเตอร์ที่จำเป็น หรือค่าของพารามิเตอร์ไม่ถูกต้อง
40001	เรียกใช้บ่อยเกินไป: คีย์ของนักพัฒนานี้เกินขีดจำกัดต่อหนึ่งนาทีของ API นี้
40008	เกินโควต้าต่อหนึ่งนาทีของแผนแพ็กเกจองค์กรสำหรับ "API ประเภทสถิติ"
40010	อินเทอร์เฟซถูกปิดชั่วคราว กรุณาลองใหม่ในภายหลัง
40100	ไม่มีสิทธิ์: ไม่มีสิทธิ์ในการดู หรือไม่สามารถดูเอเจนต์ได้ (รวมถึงเอเจนต์ที่ไม่ได้เป็นสมาชิกขององค์กร)
40105	ไม่ใช่สมาชิกขององค์กร หรือโทรไปยังที่อยู่ของศูนย์ข้อมูลอื่น
40324	ข้อผิดพลาด DevKey หรือ DevSecret
40378	ตัวแทนถูกลบ
403132	ช่วงเวลาไม่ถูกต้อง: เวลาเริ่มต้นไม่เร็วกว่าเวลาสิ้นสุด หรือเกินช่วงคําสั่งสูงสุด

ขอบเขตทางสถิติ

คําขอ: ข้อความสอบถามที่ผู้ใช้ส่ง พร้อมข้อผิดพลาดในการสนทนา (รวมถึงคําขอที่ถูกปฏิเสธเนื่องจากความถี่การโทรเกิน) สอดคล้องกับ "Agent Insight → Request Initiated" ของคอนโซล ไม่ใช่จํานวนคําขอ HTTP และจํานวนอาจแตกต่างจากจํานวนขีดจํากัดอัตราในแผน
ขอบเขตของสถิติ: นับเฉพาะช่องทางสําหรับพื้นที่พัฒนาเท่านั้น รวมถึง API, หน้าแชร์, การฝังเว็บ, ส่วนประกอบฟองสบู่, LiveDesk และช่องทางแชทหรือโทรศัพท์ต่าง ๆ; ซึ่งไม่รวมถึงการดีบักพรีวิวในพื้นที่พัฒนา การรันเวิร์กโฟลว์ หรือการใช้งานในพื้นที่ทํางานหลังจากปล่อยเอเจนต์แล้ว
ความถี่ในการอัปเดต: ข้อมูลจะถูกนับทุกชั่วโมงโดยมีความล่าช้าประมาณ 1 ชั่วโมง โดยอิงจาก data_until ข้อมูลก่อนวันที่ 9 มีนาคม 2026 ไม่มีการแบ่งย่อยตามนาที และผลลัพธ์การค้นหาคือ 0