Un cont. 300+ MCP-unelte. Direct în instrumentul de chat.

Erori

O eroare a instrumentului este returnată ca rezultat al instrumentului MCP cu isError: true. Același obiect JSON se află în structuredContent și în primul bloc de conținut text:

{
  "error_code": "WORKSPACE_ACCESS_DENIED",
  "code": "WORKSPACE_ACCESS_DENIED",
  "message": "This connection has no access to this workspace.",
  "details": {
    "error_code": "WORKSPACE_ACCESS_DENIED",
    "workspace_id": 12345
  },
  "hint": "Use po_workspaces_list to see the workspaces this connection can access. Retrying will not change the result."
}

error_code

Cod stabil, lizibil de mașină. Este replicat în code și details.error_code deoarece unele clienți rescriu error_code.

message

Explicație lizibilă pentru om.

details

Context precum http_status, retryable / retry_safe, suggested_backoff_ms, validation_errors sau ID-urile trimise.

hint

Ce trebuie făcut mai departe, redactat pentru model.

retryablehttp_status

Câmpuri opționale de nivel superior declarate în schemele de ieșire.

Nu este o eroare: când un fișier de intrare lipsește, instrumentele bazate pe fișiere (extragere, PDF) returnează un rezultat text normal care începe cu FILE_UPLOAD_REQUIRED și indică intrările acceptate sau o pagină de încărcare a browserului.

La nivelul transportului, un token lipsă, invalid, expirat sau revocat generează HTTP 401 cu un antet WWW-Authenticate (rulați din nou OAuth). În timp ce autentificarea sau catalogul de instrumente este indisponibil temporar, serverul răspunde cu HTTP 503 și Retry-After (2–5 s).

Limite de rată și cote

• Per sesiune MCP (Mcp-Session-Id): cel mult 8 apeluri de instrumente în curs. Instrumentele cu valoarea 1 în ultima coloană rulează una câte una: un al doilea apel concurent returnează imediat SESSION_BUSY (reîncercați după aproximativ 300 ms, sau 500 ms pentru po_knowledge_graph_ask). Celelalte instrumente rulează până la 4 în paralel și așteaptă până la 15 s pentru un slot disponibil.
• Per token de acces pe toate sesiunile: cel mult 24 apeluri de instrumente în curs (ACCOUNT_BUSY).
• Limitele de solicitare ale API-ului PaperOffice se aplică fiecărui apel de instrument: token-urile gratuite și pentru vizitatori primesc cel puțin 5 solicitări pe secundă, 30 pe minut, 100 pe oră și 500 pe zi; valorile planurilor pot fi mai mari. Planurile plătite cu credite rămase sunt limitate de credite, nu de o rată de solicitare. Apelurile limitate de rată nu sunt facturate; acestea returnează TRANSIENT_TRANSPORT_ERROR cu detaliile http_status 429 și timpul de așteptare în mesaj.
• Limite de timp: un apel backend este abandonat după 90 s (scrierile în baza de cunoștințe returnează apoi WRITE_OUTCOME_UNKNOWN sau TRANSLATION_IN_PROGRESS în loc să reîncerce orbete); po_knowledge_graph_ask se oprește după 120 s.
• Limite indicate în descrierile instrumentelor: până la 10 fișiere per apel po_documents_upload_files (doar /ChatGPT), 2 sau mai multe PDF-uri per fuziune, până la 500 rezultate de căutare pe pagină, până la 200 Workspaces pe pagină și 10–200 intrări în coșul de gunoi pe pagină. Link-urile de descărcare expiră după aproximativ 10 minute, iar o sarcină preluată rămâne blocată timp de 15 minute.
• Facturare: apelurile MCP sunt facturate în credite, similar cu apelurile REST API. Instrumentele ale căror descrieri indică „costă credite” sau „folosește credite” inițiază procesarea AI și utilizează mai multe credite.