API și chei de acces pentru dezvoltatori

Integrarea API cere autentificare și un contract clar. Exemplele de transport trebuie adaptate la documentația versiunii instalate.

Pașii se referă la funcționalități identificate în codul aplicației. Validarea pe o instanță live nu a fost efectuată pentru acest material; verifică documentația și opțiunile din versiunea ta.

Cum funcționează, pas cu pas

Contract și exemplu de date

Documentează target-ul cererii, identificatorul conversației, timeout-ul și modul de consum al stream-ului. Consultă documentația API pentru endpoint-uri și scheme. Nu copia un body generic între Playground, chat și RAG: acestea pot avea contracte diferite. Exemplul minimal de mai jos arată intenția, nu un payload HTTP garantat.

Harta vizuală

Urmărește săgețile continue pentru fluxul principal. Săgețile albastre punctate furnizează date sau context; cele roz punctate arată feedback sau rezultate care revin. Culorile și formele disting modelele, stocările, deciziile și rezultatele. Pe ecrane mici, derulează orizontal pentru a urmări întreaga diagramă.

Un exemplu complet

Un backend propriu apelează chat cu target și context organizație/proiect, citește stream-ul și tratează erorile. Secretul rămâne în backend; browserul nu primește cheia privată.

{"intent":"ask_policy","target":"fictional-agent","question":"What is the return deadline?"}

Încearcă tu

1. Deschide documentația API și verifică header-ele, body-ul și schema răspunsului înainte de apel.
2. Notează intrarea, sursa și rezultatul așteptat înainte să rulezi experimentul. Folosește doar datele fictive din exemplu.
3. Urmărește etapele din diagramă. La fiecare pas scrie ce informație primește și ce produce; nu confunda rezultatul intermediar cu rezultatul final.
4. Repetă cazul după eliminarea unei informații necesare sau după o intrare ambiguă. Verifică dacă sistemul cere clarificare, se oprește sau inventează.
5. Compară cu soluția comentată. Păstrează configurația, data, rezultatul și o explicație pentru orice diferență. Schimbă un singur lucru și retestează.

Soluție comentată

Clientul distinge răspuns final, timeout și acces refuzat, fără divulgarea cheii. Pentru a considera exercițiul reușit, poți arăta legătura dintre intrare, etapele parcurse și rezultat. Dacă lipsesc date, un răspuns prudent este mai util decât o completare inventată. Nu compara doar stilul: verifică și condițiile, sursele și operațiile efectuate.

Când merită și ce poate merge prost

Cheia MCP de deployment nu este automat cheia API a organizației. Alege această abordare când îmbunătățește o nevoie măsurată. Păstrează o variantă simplă ca referință și compară rezultatele pe aceleași intrări. Un singur exemplu reușit nu stabilește fiabilitatea în toate situațiile.

Verifică ce ai înțeles

De ce este prea târziu să elimini sursa privată după răspuns?

Pentru că datele au intrat deja în contextul modelului și pot fi divulgate.

Cine execută apelul propus de model?

Aplicația sau serviciul gazdă, după validare. Modelul nu primește automat acces nelimitat.

Ce rezultat trebuie să obții în acest exercițiu?

Clientul distinge răspuns final, timeout și acces refuzat, fără divulgarea cheii.

Cuvinte de ținut minte

• Autorizare / Authorization: Verificarea dreptului la o operație sau resursă.
• Tool calling: Cerere structurată de folosire a unei capabilități externe.
• Idempotency: Repetarea controlată fără duplicarea efectului.

Surse și următorul pas

• Nymrio — API documentation

Pentru pregătire: U05 — Widgetul AI pe website