Aplikasi AI (MCP)
Error & batas
Seperti apa tool yang gagal, arti setiap error koneksi, dan batas yang berlaku untuk setiap aplikasi AI.
Error tool
Saat sebuah perintah gagal (domain tidak ditemukan, kredit habis, alamat tidak valid…), tool mengembalikan hasil normal dengan isError: true. Teksnya berupa CODE: message, dengan kode yang sama seperti API, sehingga aplikasi bisa memperbaiki argumen dan mencoba lagi.
{
"content": [{ "type": "text", "text": "DOMAIN_NOT_FOUND: Domain not found or does not belong to this account." }],
"structuredContent": { "code": "DOMAIN_NOT_FOUND", "message": "Domain not found or does not belong to this account." },
"isError": true
}Error koneksi
| Status | Kode | Yang perlu dilakukan |
|---|---|---|
| 401 | MISSING_AUTH_HEADER | Tidak ada token. Aplikasi OAuth memulai proses masuk dari sini; dengan key, kirim Authorization: Bearer. |
| 401 | INVALID_TOKEN | Access token kedaluwarsa atau dicabut. Aplikasi memperbaruinya sendiri atau meminta Anda menghubungkan lagi. |
| 401 | INVALID_API_KEY | Key salah, dihapus, atau kedaluwarsa. Buat yang baru. |
| 401 | WRONG_CREDENTIAL_TYPE | Token kotak surat di server akun (atau sebaliknya). Gunakan URL yang benar. |
| 403 | ACCOUNT_BLOCKED | Akun diblokir. Hubungi dukungan. |
| 403 | IP_NOT_ALLOWED | Key dikunci ke IP lain. Tambahkan IP-nya atau gunakan OAuth. |
| 429 | RATE_LIMITED | Terlalu banyak request sekaligus. Tunggu sesuai detik Retry-After lalu coba lagi. |
Batas
Rate limit sama dengan API
Setiap koneksi dihitung terhadap batas per key atau per kotak surat yang sama dengan panggilan API Anda.
1 MB per panggilan
Argumen dibatasi 1 MB per panggilan, jadi lampiran yang dikirim melalui aplikasi AI harus kecil.
Kredit dan batas harian
Setiap email yang dikirim memakai kredit Anda (satu per penerima) dan dihitung ke batas harian Anda.
Konfirmasi sebelum bertindak
Tool yang mengirim email atau menghapus data ditandai destruktif, sehingga aplikasi bertanya dulu sebelum menjalankannya.
Pengiriman email mengikuti aturan yang sama dengan API Send Email. Kembali ke ikhtisar MCP.