Aptitudini și memorie

Aptitudini

O aptitudine (ai.skill) este un pachet reutilizabil de instrucțiuni pe care asistentul îl poate încărca în timpul unei sarcini — similar divulgării progresive din agenții moderni de programare.

Meniu: AI ‣ Configurare ‣ Comportament ‣ Aptitudini

Câmpuri

Câmp	Scop
Nume	Etichetă scurtă din interfață / catalog
Cod	ID tehnic pentru use_skill (^[a-z][a-z0-9_]*$)
Descriere	Când se folosește (în engleză; afișat modelului)
Conținut	Instrucțiuni complete când este activă (în engleză)
Mod de activare	La cerere (catalog + use_skill / cuvinte-cheie) sau Mereu activ (la fiecare rundă — folosiți cu moderație)
Cuvinte-cheie declanșatoare	Cuvinte-cheie separate prin virgulă din ultimul mesaj al utilizatorului, pentru încărcare automată
Activ / secvență	Vizibilitate și ordonare
Proveniență	Din fabrică / personalizată (și modificată din fabrică)

Comportament la rulare

• CRUD este rezervat exclusiv AI Administrator.

• La rulare, fiecare utilizator AI vede aceleași aptitudini active (fără comutator de aptitudine per utilizator).

• Instrumentele list_skills / use_skill necesită capabilitatea ask.

• Limitele plafonează dimensiunea catalogului, numărul de aptitudini mereu active și lungimea conținutului, astfel încât o singură aptitudine să nu domine promptul.

Aptitudini din fabrică

Modulul livrează aptitudini din fabrică (date XML, noupdate). Exemplele includ playbook-uri operaționale pentru facturi furnizor, modele de reconciliere bancară, urmăriri și câmpuri de produs conștiente de localizare — ancorate în stack-urile eYssen acolo unde este cazul.

• Acțiunea de administrare Sync factory skills reîmprospătează din cod, la actualizare, rândurile din fabrică neatinse.

• Dacă editați o aptitudine din fabrică, aceasta devine modificată din fabrică și nu este suprascrisă automat; o puteți reseta la valoarea din fabrică când doriți.

Factură furnizor din documente (vendor_bill_from_documents)

Playbook AP complet pentru Odoo 18: PDF-uri din chat sau ciorne de facturi furnizor (in_invoice) care au atașamente, dar linii goale. Nu este o aptitudine pentru creanțe / facturi client.

Ce este conceput să facă:

• Rezolvă indicatorii de partener, reutilizează modelele de produs / cont / taxă / analitic din facturile anterioare ale aceluiași furnizor.

• Completează liniile de factură doar pe mișcările în ciornă.

• Programează un To-Do de verificare umană pe fiecare factură pe care a modificat-o efectiv.

• Calea geamănului NAV maghiar (înainte de completarea liniilor): mulți furnizori din Ungaria există deja ca facturi importate din NAV. Dacă se găsește exact o potrivire clară (adesea deja postată), aptitudinea reatașează imaginea/PDF-ul din ciorna goală la factura existentă, notează îmbinarea și șterge legătura ciornei goale numai dacă aceasta încă nu are linii semnificative — nu trebuie să înregistreze de două ori aceeași factură. Furnizorii din afara Ungariei / străini omit această cale.

Opriri obligatorii în playbook:

• Nu postați, nu plătiți și nu scrieți câmpurile de transmitere NAV.

• Nu inventați parteneri, taxe sau conturi atunci când reutilizarea facturilor anterioare eșuează — lăsați pentru om.

• Preferați raportarea unei facturi existente în locul creării unei a doua cu același partener + aceeași referință.

Asociați cu Rețeta D din Rețete pentru agenți (ajutor în chat sau agent programat). La un agent programat, sarcina permanentă scoutează (caută ID-uri, queue_work_items), iar fiecare copil rulează acest playbook pentru o singură factură — consultați Elemente de lucru pe înregistrare. Pentru rulările nesupravegheate, Mod de scriere auto al sarcinii este potrivit doar pentru că această aptitudine păstrează facturile în ciornă; dacă personalizați aptitudinea pentru a posta, readuceți sarcina pe confirm.

Scrierea unei aptitudini bune

• Precizați clar declanșatorii în descriere.

• Dați pași ordonați și indicați ce instrumente se apelează primele.

• Spuneți ce să nu se inventeze (conturi, taxe, parteneri).

• Păstrați aptitudinile mereu active scurte; puneți playbook-urile lungi la cerere.

Memorie

Memoria (ai.memory) stochează fapte durabile pe care asistentul le poate reaminti între conversații.

Meniu: AI ‣ Memorie ‣ Amintiri și Graf de memorie.

Tipuri

• În lucru — context de sarcină de scurtă durată

• Episodic — ce s-a întâmplat într-o sesiune

• Semantic — fapte / preferințe durabile

• Arhivă — stocare rece

Domenii

• Utilizator (implicit privat)

• Companie / Sistem — administrator (sau promovare aprobată)

• Agent / Rulare — context centrat pe agent

Utilizatorii pot crea/scrie în domeniile utilizator, agent și rulare; domeniile companie/sistem necesită administrator sau aprobarea unei promovări.

Instrumente

Sub capabilitatea ask: memory_search, memory_save, memory_forget, memory_link. Injectarea amintirilor în prompt este limitată ca dimensiune.

Bune practici

• Salvați preferințele stabile („utilizatorul dorește formatul de dată HU”) ca semantic/utilizator.

• Nu stocați în memorie parole, chei API sau documente de identitate personale complete.

• Analizați periodic amintirile de la nivel de companie; tratați-le ca pe o configurare partajată.

• Folosiți forget atunci când un fapt este greșit — nu acumulați contradicții.

Aptitudini versus memorie

Aptitudini	Memorie
Cum se face o lucrare (playbook-uri)	Ce este adevărat pentru acest utilizator/această organizație (fapte, preferințe)
Configurare scrisă de administrator	Scrisă de utilizator/agent/la rulare
Posibilă versionare din fabrică	Date operaționale