Agenți AI

Un agent AI este un asistent cu mai mulți pași. Citește conversația, planifică, apelează instrumente (instrumentele dumneavoastră AI, instrumentele MCP și o căutare în baza de cunoștințe), analizează rezultatele și apelează din nou modelul până când are un răspuns. Nodul Creează finalizare de chat AI face un singur apel de model și răspunde; nodul Agent AI poate continua prin mai multe apeluri de model și de instrumente, în limitele pe care le setați, înainte de a răspunde.

Folosiți un agent când o cerere necesită mai mulți pași, de exemplu „găsește comanda clientului, verifică starea livrării și propune o dată nouă”. Pentru un răspuns direct pe baza instrucțiunilor și a unei baze de cunoștințe, nodul AI este mai simplu și mai ieftin.

Elementele de bază

Element	Ce este	Unde îl setați
AI Harness	Motorul care rulează bucla agentului: cel propriu MonoChat, un SDK de agenți sau un serviciu de agenți găzduit.	Setări › Automatizare › Harness-uri AI
Modele	Modelele AI cu care gândește agentul: un model principal, un model de rezervă opțional și un model rapid opțional. Harness-urile găzduite folosesc în schimb modelele propriului furnizor.	Nodul Agent AI
Instrumente	Domenii AI, funcții de tip Instrument AI și instrumente MCP.	Nodul Agent AI
Buget de execuție	Limite pentru apelurile de model, apelurile de instrumente, tokeni, durată și reîncercări la fiecare rulare.	Nodul Agent AI
Rulare	O execuție a agentului. Fiecare rulare este înregistrată în Rulări agent AI.	Creată de nod sau de API

Harness-uri AI

Setări › Automatizare › Harness-uri AI listează harness-urile pe care pot rula agenții dumneavoastră: cele pe care MonoChat le oferă tuturor spațiilor de lucru și cele pe care le adăugați cu propriile credențiale.

Harness	Unde rulează	Modele folosite	Cine îl adaugă
MonoChat Native	În MonoChat	Modelele dumneavoastră AI	MonoChat
OpenAI Agents SDK	În MonoChat	Modelele dumneavoastră AI	MonoChat
Claude Agent SDK	Pe agent runner-ul MonoChat	Modelele dumneavoastră AI	MonoChat
pi	Pe agent runner-ul MonoChat	Modelele dumneavoastră AI	MonoChat
OpenAI Agents API	În cloud-ul OpenAI	Modelele permise ale harness-ului	Dumneavoastră, cu cheia dumneavoastră API OpenAI (MonoChat poate oferi și el una)
Claude Managed Agents	În cloud-ul Anthropic	Modelele permise ale harness-ului	Dumneavoastră, cu cheia dumneavoastră API Anthropic (MonoChat poate oferi și el una)
Custom Endpoint	Pe propriul dumneavoastră server	Modelele dumneavoastră AI (opțional)	Dumneavoastră, cu endpoint-ul și secretul dumneavoastră

Harness-urile care rulează în MonoChat sunt oferite de MonoChat; spațiul dumneavoastră de lucru poate adăuga doar harness-uri care folosesc propriile credențiale. Claude Agent SDK și pi necesită agent runner-ul MonoChat: unde acesta nu este configurat, o rulare pe ele eșuează cu „Acest harness nu este disponibil pe acest server.”

Indiferent de harness, MonoChat rămâne în control: fiecare apel de model al unui harness care folosește modelele dumneavoastră AI trece prin MonoChat (astfel se aplică facturarea și bugetul), fiecare apel de instrument rulează funcțiile, instrumentele MCP și domeniile AI din spațiul dumneavoastră de lucru, iar bugetul este impus pe orice harness.

Adăugați un harness

1. Accesați Setări › Automatizare › Harness-uri AI și faceți clic pe + (Creați).
2. Introduceți un Nume și, opțional, o Descriere.
3. Alegeți Harness-ul. Fiecare opțiune indică unde rulează.
4. La Credențiale, introduceți ce are nevoie harness-ul:
   • OpenAI Agents API, Claude Managed Agents: Cheie API.
   • Custom Endpoint: Endpoint și Cheie API.
5. Pentru un harness găzduit, completați Modele permise: introduceți numele modelelor furnizorului (de exemplu ID-ul unui model OpenAI sau Anthropic). Folosiți Adaugă model pentru până la 10 modele. Agenții de pe acest harness pot alege doar din această listă.
6. Faceți clic pe Salvați.

Când editați un harness, tipul Harness nu poate fi schimbat, iar câmpul pentru cheie arată Cheie API (lăsați gol pentru a păstra cheia salvată).

Claude Managed Agents

Prima dată când este folosit un harness de acest tip, MonoChat creează un agent și un mediu în contul Anthropic respectiv și le reutilizează ulterior.

Custom Endpoint

Un harness Custom Endpoint trimite rulările către propriul dumneavoastră serviciu, de exemplu un agent autogăzduit. Pentru fiecare rulare, MonoChat trimite un POST la <Endpoint>/runs cu Authorization: Bearer <API Key>. Corpul conține ID-ul rulării, instrucțiunile, intrarea, mesajele conversației, bugetul, aliasurile modelelor (agent-main, agent-fallback, agent-fast) și trei URL-uri cu un token pentru această rulare:

• un gateway de modele (URL-uri de bază compatibile OpenAI …/v1 și compatibile Anthropic) care apelează modelele AI ale nodului și impune bugetul,
• un server MCP care expune instrumentele rulării,
• un URL de evenimente la care serviciul dumneavoastră raportează rezultatul (completed cu result sau failed cu error).

Tokenul rulării nu mai funcționează când rularea se încheie.

Nodul Agent AI

Adăugați un agent într-un flux cu nodul Agent AI, între nodurile hibride din designerul de fluxuri. Consultați Fluxuri pentru modul de adăugare și conectare a nodurilor.

Câmpuri

Secțiune	Câmp	Descriere
	Nume	Numele nodului afișat pe canvas.
	AI Harness	Obligatoriu. Harness-ul care rulează agentul.
	Instrucțiuni	Instrucțiunile de sistem ale agentului: rolul, tonul, regulile și ce are voie sau nu să facă.
	Sarcină (adăugată la instrucțiunile agentului; se pot folosi etichete)	Ce îi cere acest nod agentului. Se adaugă după instrucțiuni și poate folosi aceleași etichete ca promptul nodului AI, de exemplu pentru a include datele clientului.
Modele	Model principal	Modelul pe care îl folosește agentul. Obligatoriu pentru orice harness, cu excepția Custom Endpoint.
	Model de rezervă (după limita flexibilă)	Modelul la care trece agentul după ce atinge limita flexibilă de apeluri de model, de obicei un model mai ieftin sau mai rapid.
	Model rapid (sarcini ușoare în fundal)	Un model pe care un harness îl poate folosi pentru apelurile sale ușoare în fundal.
	Model (unul dintre modelele permise ale harness-ului)	Afișat în locul celor trei câmpuri de mai sus pentru un harness găzduit.
Sesiune de agent	Conversație	Continuă sesiunea existentă a agentului (implicit) sau Începe o sesiune nouă a agentului. Consultați Sesiunile agentului.
	Cheie sarcină (sesiuni de agent separate pentru fiecare sarcină)	Opțional. Păstrează o sesiune de agent separată pentru fiecare cheie în aceeași conversație, de exemplu booking și support.
	Limită istoric mesaje	Câte mesaje din conversație primește agentul.
	Modele AI pentru transcriere vocală	Un model cu Transcriere. Mesajele vocale din conversație ajung la agent ca text.
Setări instrument	Domenii AI	Bazele de cunoștințe în care poate căuta agentul. Sunt oferite agentului ca instrument de căutare în baza de cunoștințe.
	Instrument AI	Funcțiile de tip Instrument AI pe care le poate apela agentul.
	Setați instrumentele de conținut client MCP AI	Deschide panoul în care adăugați instrumente MCP. Consultați Clienți MCP.
Mesaje	Trimite mesajele intermediare către client	Dezactivat implicit. Ce scrie agentul cât timp încă lucrează (de exemplu „Să verific comanda dumneavoastră”) este trimis clientului când opțiunea este activată; când este dezactivată, este adăugat conversației ca notă internă, vizibilă doar echipei dumneavoastră.
	Trimiteți răspunsul	Activat implicit. Trimite clientului răspunsul final al agentului. Dezactivați-l pentru a folosi răspunsul doar în interiorul fluxului.
Buget de execuție	Număr maxim de apeluri de model	Implicit 4.
	Limită flexibilă: apeluri de model	Opțional. După atâtea apeluri de model, agentul trece la modelul de rezervă. Trebuie să fie mai mică decât Număr maxim de apeluri de model și necesită un model de rezervă.
	Număr maxim de apeluri de instrumente	Implicit 6. Cu 0, rularea se încheie cu Buget depășit imediat ce agentul încearcă să apeleze un instrument.
	Număr maxim total de tokeni	Implicit 20000. Tokenii de intrare și de ieșire ai tuturor apelurilor de model din rulare.
	Durată maximă (secunde)	Implicit 30.
	Număr maxim de reîncercări	Implicit 2. De câte ori este reîncercat un apel de model eșuat.

sfat

Scrieți regulile stabile în Instrucțiuni și sarcina specifică a acestui pas în Sarcină. Astfel, mai multe noduri Agent AI dintr-un flux pot folosi aceleași instrucțiuni și pot diferi doar prin sarcină.

avertisment

Harness-urile găzduite nu acceptă o limită flexibilă, deoarece nu pot trece la un model de rezervă. Lăsați gol Limită flexibilă: apeluri de model pentru ele.

Ce se întâmplă când fluxul ajunge la nod

1. MonoChat verifică soldul și setările nodului și pornește o rulare. Rularea este În coadă, apoi În execuție. Instanța de flux așteaptă la nod.
2. Agentul primește instrucțiunile și sarcina și, când fluxul aparține unei conversații, mesajele conversației până la Limită istoric mesaje, cu mesajele vocale transcrise.
3. Agentul apelează modele și instrumente până când are un răspuns sau atinge o limită. Textul pe care îl scrie între apelurile de instrumente este tratat ca mesaj intermediar.
4. Când rularea se încheie:
   • dacă s-a Finalizat și Trimiteți răspunsul este activat, răspunsul este trimis clientului. Răspunsurile lungi sunt împărțite în mai multe mesaje când depășesc limita canalului (4096 de caractere pe WhatsApp);
   • dacă s-a încheiat în orice alt mod, o notă internă „Rularea agentului AI s-a încheiat: stare. eroare” este adăugată conversației pentru echipa dumneavoastră.
5. Fluxul continuă pe ieșirea care corespunde modului în care s-a încheiat rularea.

Rulările aceleiași sesiuni de agent sunt procesate pe rând, în ordine.

Ieșiri

Ieșire	Când
Finalizat	Agentul a terminat cu un răspuns.
Buget depășit	Rularea a consumat Număr maxim de apeluri de model, Număr maxim de apeluri de instrumente sau Număr maxim total de tokeni.
Timp expirat	Rularea a atins Durată maximă (secunde).
Ură, Jailbreak, Autovătămare, Conținut sexual, Violență	Filtrul de conținut al furnizorului de modele a oprit rularea pentru această categorie. Sunt aceleași ieșiri pe care le are nodul AI.
La eșec	Rularea a eșuat din orice alt motiv sau a fost anulată. O oprire de către filtrul de conținut ajunge tot aici pe nodurile salvate înainte să existe aceste ieșiri; deschideți și salvați un astfel de nod pentru a le obține.

Conectați cel puțin Finalizat și La eșec. Un tipar frecvent este să trimiteți Buget depășit, Timp expirat și La eșec către un nod Atribuiți conversația, astfel încât un coleg să preia conversația.

Sesiunile agentului

O sesiune de agent este memoria agentului între rulări. MonoChat păstrează o singură sesiune de agent activă pentru fiecare conversație, harness și cheie de sarcină.

• Continuă sesiunea existentă a agentului o reutilizează, astfel încât agentul reia de unde a rămas. Pe harness-urile găzduite continuă și sesiunea proprie a furnizorului.
• Începe o sesiune nouă a agentului o închide pe cea activă și începe de la zero, de exemplu la începutul unui subiect nou.
• O Cheie sarcină păstrează sesiuni independente una lângă alta în aceeași conversație.

Facturare

• Apelurile de model pe modelele AI oferite de MonoChat sunt facturate din soldul dumneavoastră ca de obicei. Apelurile pe modelele dumneavoastră sunt facturate de furnizorul dumneavoastră.
• Un harness oferit de MonoChat poate adăuga propriile taxe per rulare, per minut și per apel de instrument și, pentru un harness găzduit, tokenii raportați de furnizorul său. Acestea apar în Tranzacții ca Rulare agent AI, Durată agent AI, Apel de instrument al agentului AI și categorii de tokeni AI.
• Un harness adăugat de dumneavoastră cu propriile credențiale nu are taxă MonoChat; furnizorul său vă facturează.
• O rulare nu pornește dacă soldul este insuficient.

Evenimentul Rularea agentului AI s-a încheiat

Rularea agentului AI s-a încheiat este un nod de eveniment. Se declanșează când se încheie o rulare legată de un client, indiferent dacă rularea a fost pornită de un flux sau prin API cu o conversație. Ca alte noduri de eveniment, are setări opționale Condiție și Timp expirat. Folosiți-l pentru a porni un flux separat după rulările agentului, de exemplu pentru a înregistra rezultatele sau a notifica o echipă.

Porniți un agent din cod

Funcțiile personalizate și clienții API pot rula agenți cu aceste metode (permisiunea Pornire / Citire / Anulare rulări ale agenților AI în automatizare):

Metodă	Ce face
business.tenants.automation.ai.aiAgentRuns.create	Pornește o rulare. Returnează aiAgentRunId și aiAgentSessionId.
business.tenants.automation.ai.aiAgentRuns.show	Returnează o rulare (_id) cu starea, consumul, pașii și rezultatul.
business.tenants.automation.ai.aiAgentRuns.cancel	Anulează o rulare aflată în coadă sau în execuție (_id).

create primește aiHarnessClientId, input (sarcina), opțional sessionId (pentru a lucra într-o conversație), aiAgentSessionId, taskKey și isNewSession, precum și options cu aceleași setări ca nodul: instructions, aiModelClientId, fallbackAiModelClientId, fastAiModelClientId, harnessModel, toolCustomFunctionIds, aiScopeIds, aiMcpClientDatas, messageHistoryLimit, speechToTextAiModelClientId, forwardIntermediateMessages, willSendAnswer și un budget obligatoriu. Prin API, forwardIntermediateMessages și willSendAnswer au implicit valoarea false.

const { aiAgentRunId } = await sdk.method({ name: 'business.tenants.automation.ai.aiAgentRuns.create' }).callAsync({
  payload: {
    aiHarnessClientId: 'HARNESS_ID',
    input: 'Summarise the open orders of this customer.',
    sessionId: 'SESSION_ID',
    options: {
      instructions: 'You are the order assistant of our store.',
      aiModelClientId: 'MODEL_ID',
      toolCustomFunctionIds: ['FUNCTION_ID'],
      budget: { maxLlmCalls: 4, maxToolCalls: 6, maxTotalTokens: 20000, maxDurationSeconds: 30, maxRetries: 2 },
    },
  },
})

Rularea este asincronă: citiți-o mai târziu cu show sau reacționați la ea cu evenimentul Rularea agentului AI s-a încheiat. Fără sessionId, fiecare apel pornește o sesiune de agent nouă, cu excepția cazului în care transmiteți aiAgentSessionId returnat de un apel anterior; agentul vede atunci rulările finalizate anterior ale acelei sesiuni de agent ca istoric. Consultați Method pentru apelarea metodelor dintr-o funcție.

Permisiuni

Permisiune	Permite
Citire / Creare / Actualizare / Ștergere harness-uri AI în automatizare	Gestionarea Harness-uri AI
Citire rulări ale agenților AI în automatizare	Vizualizarea Rulări agent AI
Pornire rulări ale agenților AI în automatizare	Apelarea aiAgentRuns.create
Anulare rulări ale agenților AI în automatizare	Apelarea aiAgentRuns.cancel

Consultați Roluri.

Legate de acest subiect

• Rulări agent AI: vedeți ce a făcut fiecare rulare
• Modele AI
• Clienți MCP
• Domenii AI
• Fluxuri