Conectează un agent

Conectează Signit o singură dată, atașează PDF-ul în conversație, apoi cere:

Folosește Signit pentru a trimite acest PDF atașat spre semnare către Ana (ana@example.com), Bogdan (bogdan@example.com) și Carmen (carmen@example.com). Semnare paralelă, invitații în română.

Agentul transferă atașamentul original, creează un Document și îl trimite prin același flux ca interfața Signit. Nu trebuie să încarci documentul separat în Signit. Include numele și adresa de email a fiecărui Semnatar; agentul trebuie să ceară adresele lipsă. Dacă îi ceri doar să pregătească o ciornă, trebuie să aștepte instrucțiunea de trimitere.

Implicit, Signit citește întregul PDF în fundal și pune câmpurile fiecărui Semnatar la blocurile lui de semnătură (autoDetectSignatureFields, implicit true). Cere în schimb o pagină de semnături și agentul transmite false: fără analiză, fiecare Semnatar semnează pe o pagină adăugată. Cât timp PDF-ul este încă citit, o cerere de trimitere așteaptă scurt, apoi raportează poziționarea în așteptare cu o indicație retryAfterSeconds; nu se trimite nimic, iar agentul reia aceeași cerere.

Alege clientul

• Claude.ai: atașează un PDF de cel mult 3 MiB. Sunt necesare execuția de cod și accesul de rețea la domeniul Signit.
• ChatGPT: adaugă Signit în Developer mode și atașează un PDF de cel mult 25 MiB. Disponibilitatea depinde de cont și de politica spațiului de lucru.

Endpoint-ul găzduit este https://app.sign-it.ro/mcp. Autentificarea folosește OAuth, fără API key Signit. Conexiunile existente trebuie reconectate pentru aprobarea permisiunilor de creare și trimitere.

Acces și semnare

Agentul acționează ca Utilizatorul tău Signit, în limitele accesului existent, în organizația selectată. Dacă schimbi organizația în aplicație, o schimbi și pentru agent (vezi Gestionează organizația). Îl poți revoca din Conexiune agent. Trimiterea cere semnăturile altor persoane; nu semnează în locul lor. Conectorul listează și Semnăturile tale în așteptare, permite inspectarea PDF-ului autorizat și semnarea explicită a propriei solicitări eligibile. Inspectarea listează fiecare câmp pregătit pentru tine (pagină și poziție) și un fieldSetDigest; semnarea trebuie să confirme acest digest și aplică numele adoptat în fiecare câmp din set. Citește întregul PDF înainte să aprobi numele adoptat și consimțământul. Revizuirea găzduită este limitată la 3 MiB și necesită un client care poate citi resursa PDF privată.

Verifică starea și anulează

Agentul poate verifica un document trimis de tine cu signit_get_envelope_status: stadiul fiecărui semnatar, pe cine mai așteaptă și când a fost trimis, finalizat sau anulat. Vede doar documentele tale.

Dacă îi ceri să anuleze un document, agentul îl anulează cu signit_void_envelope. Semnatarii care nu au semnat primesc un e-mail că documentul a fost anulat, iar după aceea nimeni nu mai poate semna. Copiile semnate sunt păstrate. Motivul este opțional, de cel mult 500 de caractere, și semnatarii îl văd în acel e-mail. Dacă documentul este deja anulat, o nouă anulare nu schimbă nimic. Agentul nu are un instrument de reamintire: trimite reamintirile din pagina documentului în Signit.

Câmpuri text și casete de bifare

Când le ceri, agentul poate adăuga câmpuri Text și Casetă de bifare la crearea unui document. Fiecare numește semnatarul prin e-mail, o key, o etichetă, pagina și poziția. Signit le verifică după aceleași reguli ca editorul; agentul nu trebuie să inventeze câmpuri, etichete sau text precompletat pe care nu le-ai cerut. O ciornă cu astfel de câmpuri se trimite doar cu expectedDefinitionRevision returnat la creare. Dacă Signit plasează apoi câmpurile de semnătură, trimiterea returnează câmpurile concrete, pozițiile, semnatarii, digestul originalului și noua revizie. Agentul trebuie să îți arate aceste poziții și să confirme setul de câmpuri înainte de a reîncerca trimiterea.

Un document cu câmpuri Text sau Casetă de bifare (signingFormatVersion 2) se semnează în trei pași, chiar dacă partea ta are doar semnături:

1. Inspectarea listează câmpurile, răspunsurile tale salvate, răspunsurile trimise de ceilalți semnatari și, în completion.answerFieldIds, exact câmpurile la care răspunzi tu.
2. Revizuirea (signit_review_signature) trimite răspunsurile și numele adoptat către Signit, care returnează tot ce va apărea pe document. Agentul trebuie să îți arate aceste valori și să îți ceară consimțământul.
3. Semnarea trimite aceleași răspunsuri cu tokenul de revizuire. Răspunsurile schimbate necesită o nouă revizuire; revizuirea expiră după o oră.

Agentul transmite doar răspunsurile pe care le-ai spus: null înseamnă „necompletat” pentru text și „lăsat nebifat” pentru o casetă. Signit înregistrează că agentul tău conectat le-a trimis. Un apel doar pentru semnătură la un astfel de document este refuzat înainte să se salveze ceva.

Noile fluxuri cu atașamente necesită încă verificare efectivă în Claude.ai și ChatGPT; testele serverului nu confirmă comportamentul fiecărui cont client.