Capabilități și instrumente¶

Capabilitățile sunt comutatoare principale care decid ce clase de instrumente pot fi oferite modelului și pe care le va executa poarta de acces. Se configurează în AI ‣ Configurare ‣ Comportament ‣ Capabilități.

Câmpurile înregistrării de capabilitate¶

Cod — cod tehnic stabil (ask, read, write, …).
Nume — eticheta din interfață.
Este activat — comutator global de dezactivare.
Limitat la grupuri — gol = toți utilizatorii AI (care trec celelalte verificări); altfel doar acele grupuri Odoo.
Delimitare opțională pe companie.

Important

Dezactivarea unei capabilități ascunde instrumentele ei și face poarta să le respingă dacă modelul inventează un apel. Oferirea unui instrument fără capabilitate nu este posibilă prin meniul normal; poarta rămâne autoritatea.

Capabilități livrate¶

Cod	Activat implicit	Rol
`ask`	Da	Ajutoare pentru întrebări și răspunsuri: căutare în schemă, mediu, aptitudini, memorie, listare acțiuni, prezentare opțiuni
`read`	Da	`search`, `read`, `read_group`, `get_fields`
`navigate`	Da	Deschide interfața la care utilizatorul are acces
`write`	Nu	`create_record`, `update_record`, atașare de fișier (împreună cu web)
`delete`	Nu	`delete_record`
`web`	Nu	`web_search`, `web_fetch`
`mcp`	Nu	Instrumente dinamice de la serverele MCP
`action`	Nu	`call_action` pe metode din lista de permise
`customize`	Nu; implicit grupul AI Administrator	Instrumente de personalizare a vizualizărilor/câmpurilor/modelelor
`setup`	Da, doar grupul Settings	Instrumente de instalare ghidată a modulelor

Catalogul de instrumente (încorporate)¶

Ask (întrebări)¶

search_docs — căutare după cuvinte-cheie în modelele/câmpurile pe care utilizatorul le poate folosi.
get_environment — versiune, ediție, companie, utilizator, module opționale, în timp real.
list_skills / use_skill — catalogul de aptitudini și încărcarea conținutului.
list_allowed_actions — ce acțiuni de business sunt în lista de permise.
memory_search / memory_save / memory_forget / memory_link.
present_choices — opțiuni structurate pentru interfață.

Read (citire)¶

search — căutare cu domeniu + citire câmpuri (limită plafonată).
read — după ID-uri explicite (eșuează dacă sunt prea multe ID-uri; nu taie tacit).
read_group — agregări (măsuri validate; domeniile sunt verificate de politică).
get_fields — schemă (indicatori de obligativitate; nu domenii apelabile brute).

Write / delete (scriere / ștergere)¶

create_record / update_record / delete_record — întotdeauna prin poartă; pot deveni scrieri în așteptare.
queue_work_items — pune în coadă ID-uri de înregistrări pentru rulări copil izolate ale sarcinii permanente curente (max. 200 de ID-uri pe apel). Indisponibil din chat fără o rulare de sarcină, din rulări din inbox sau dintr-un copil. Consultați Elemente de lucru pe înregistrare.
fetch_file_to_field — necesită web și write.

Internet¶

web_search / web_fetch — supuse listei de domenii permise și plafoanelor zilnice.

Action (acțiune)¶

call_action — numai metodele prezente în Acțiuni permise.

Navigate / customize / setup (navigare / personalizare / configurare)¶

navigate — ajutoare de navigare în interfață.
Instrumente de personalizare — inspectarea/aplicarea lanțului de vizualizări, câmpuri/modele personalizate, anulare, import/export al personalizărilor (administrator).
Instrumente de configurare — previzualizarea/instalarea modulelor prin controale de configurare ghidată.

Plafonul de capabilități al agentului¶

Pe ai.agent, Capabilități intersectează în plus ce poate folosi acel agent. Un agent cu doar ask + read nu poate executa instrumente de scriere, chiar dacă Write este activat global pentru oameni.

Pentru rulările ad-hoc pe canal cu domeniul intersect, clasele de capabilități efective sunt:

effective = agent.capability_ids ∩ requester.allowed_capabilities
            (and global enabled flags / group restrictions)

Domeniul agent_full folosește capabilitățile agentului fără a le intersecta cu clasele de capabilități ale solicitantului. Accesul la date folosește în continuare ACL-ul Odoo al utilizatorului agent + politica AI — nu regulile de înregistrare ale solicitantului. Consultați Agenți.

Activarea sigură a scrierii (model pilot)¶

Păstrați Write dezactivat global.
Creați un grup Odoo, de ex. AI Writers.
Activați capabilitatea Write cu Limitat la grupuri = AI Writers.
Adăugați reguli allow perm_create / perm_write la nivel de model doar pentru modelele din pilot (Politică de acces).
Încercați scrierile de care pilotul are efectiv nevoie. Regulile la nivel de model nu sunt suficiente singure: multe câmpuri obișnuite scriu și într-un al doilea model, iar poarta le refuză chiar și sub o permisiune la nivel de model. Fiecare necesită o regulă care numește câmpul, cu perm_write = Allow — consultați Protecția scrierii între modele. Descoperirea lor prin încercare este sigură, deoarece acest refuz nu înregistrează nicio încălcare și nu costă niciun avertisment.
Păstrați modul de scriere pe confirm sau hybrid.
Monitorizați jurnalele și încălcările timp de două săptămâni înainte de a extinde.