Español
English
Deutsch
Français
Português
Italiano
Nederlands
PolskiOn és el botó i quan es veu
La fitxa s'obre des del menú Mirakl › AI Assistant › Ask the AI. A la fitxa tens el camp Marketplace, el camp Question i el botó Ask. El botó no depèn de cap estat: es veu en tot moment i existeix a Odoo 17, 18, 19 i 20.
Els camps Answer i Note arrenquen amagats i els omple el codi, no tu. Answer només apareix quan la consulta ha anat bé. Note apareix quan la consulta acaba sense clau, amb la IA desactivada, com a no disponible o amb error, i es mostra sense rètol, només el seu text.
Amb Odoo en castellà el botó es diu Preguntar. L'esquema següent recull com es diu en altres idiomes.
Ask es veu com Preguntar en castellà, Fragen en alemany, Demander en francès, Chiedi en italià i Perguntar en portuguès.
Un cas per seguir-ho: Hogar Norte
Exemple Cas il·lustratiu: l'empresa i les seves dades són inventades per explicar el flux.
Hogar Norte és una empresa inventada que ven en un marketplace Mirakl i té el connector amb la seva subscripció. L'Elena, d'administració, obre la fitxa, escriu a Question quina comissió li està costant el marketplace i prem Ask. Això és el que va passant, en l'ordre en què ho comprova el codi.
Primera pulsació: la IA està apagada
La primera cosa que mira el botó és si la instància té la IA activada. Si no, deixa la consulta en estat d'IA desactivada, escriu a Note aquest text i torna a obrir la fitxa, sense més:
AI is disabled on this marketplace. Enable it on the instance (Configuration ▸ Instances ▸ AI).
La casella és a la fitxa de Mirakl Instances, pestanya AI (optional), i es diu Enable AI insights. Ve sense marcar. La seva ajuda diu: «Optional. The connector works fully without AI. If you don't enable this / don't set a key, no AI call is ever made and nothing changes.» Hogar Norte la marca. Els altres camps d'aquesta fitxa els repassa aquesta guia.
Segona pulsació: la IA allotjada i el que s'envia
La instància d'Hogar Norte treballa per FlexigoTech Cloud, i en aquest cas el mòdul només fa servir la IA allotjada. El botó fa llavors dues comprovacions abans de construir res:
- Que el servei de la subscripció està actiu. Si no ho està, el botó s'atura amb l'avís per subscriure's i no s'envia res.
- Que l'empresa ha acceptat el que s'envia. Fins llavors no es construeix ni s'envia res.
Si falta l'acceptació, hi ha dos camins segons qui prem. Una persona amb perfil de responsable de Mirakl que treballa en aquesta empresa veu la finestra AI analysis in FlexigoTech Cloud: what is sent; en prémer Accept la consulta continua. Qualsevol altra persona rep l'estat de no disponible i aquesta nota:
Nothing was sent. Before the AI analysis sends anything to FlexigoTech Cloud, a Mirakl manager of … has to accept what it sends: What is sent, on the AI (optional) tab of the marketplace (Mirakl ▸ Configuration ▸ Marketplaces).
L'Elena no és responsable de Mirakl, així que veu aquesta nota. Un responsable ho accepta a What is sent i ella torna a preguntar. En l'estat de no disponible el botó no deixa cap registre de la consulta.
Si la instància fa servir la seva pròpia clau
Quan la instància no treballa per FlexigoTech Cloud, no hi ha comprovació de subscripció ni d'acceptació al botó. El que mira és la clau de la IA. Si és buida, deixa l'estat de sense clau, escriu el següent i torna a obrir la fitxa sense cridar la IA:
No AI API key configured. Add one on the instance (Configuration ▸ Instances ▸ AI).
Què prepara i què envia
Superades les comprovacions, el botó prepara un full de xifres del marketplace. Busca el tauler de control d'aquesta instància (si no existeix, el crea) i recalcula els seus indicadors; si aquest càlcul falla, ho anota al registre del servidor i continua amb el que hi hagi. El full porta:
- El nom del marketplace i la moneda de l'empresa.
- Comandes, volum de vendes, valor mitjà de la comanda i comissió total i percentual.
- Pagament net, liquidacions i les pendents de revisar.
- Ofertes i les que estan en error, i devolucions.
El mateix codi la descriu sense claus d'API i sense dades personals. La pregunta s'afegeix a aquestes xifres. Amb la IA allotjada l'enviament es redueix al nom, la moneda, les xifres i la pregunta (retallada a un màxim), sense més text de la teva base de dades. Amb clau pròpia, la consulta va al proveïdor configurat a la instància amb la pregunta i el full de xifres.
Què veus en acabar i què queda desat
Si la IA contesta bé, Answer mostra el text i Note queda buida. Si falla la crida (xarxa, format de la resposta o proveïdor desconegut), l'estat passa a error i Note mostra el text de l'error, retallat i amb la clau substituïda per asteriscs si hi apareixia.
Els avisos d'IA desactivada i de manca de clau es queden a Note i no creen cap informe. Quan la consulta arriba a la crida a la IA i el resultat no és el de no disponible, es registra per a auditoria com un informe d'IA amb el nom Ask the AI seguit del nom del marketplace. Desa la resposta, el proveïdor, el model, els tokens d'entrada i sortida, l'estat i la nota d'error. Després la finestra es torna a obrir amb el resultat.
Resum d'avisos
El que veus a Note | Quan surt | Què fer |
|---|---|---|
AI is disabled on this marketplace. Enable it on the instance (Configuration ▸ Instances ▸ AI). | La casella Enable AI insights de la instància està sense marcar | Marcar-la a la pestanya AI (optional) |
No AI API key configured. Add one on the instance (Configuration ▸ Instances ▸ AI). | La instància no treballa per FlexigoTech Cloud i no té clau | Afegir la clau a la instància |
Nothing was sent. Before the AI analysis sends anything to FlexigoTech Cloud, a Mirakl manager of … has to accept what it sends: What is sent, on the AI (optional) tab of the marketplace (Mirakl ▸ Configuration ▸ Marketplaces). | Instància per FlexigoTech Cloud, empresa sense acceptar i el teu usuari no pot acceptar | Que un responsable de Mirakl de l'empresa accepti What is sent |
| Text d'error variable | La crida a la IA ha fallat | Llegir el text de Note |
El camí sense prémer el botó
El botó serveix per fer una pregunta concreta. A part, la tasca programada Mirakl - AI Weekly Digest s'executa cada setmana i està activa en instal·lar. Reutilitza el mateix full de xifres i la mateixa crida a la IA, que al seu torn comprova el proveïdor i l'acceptació. El seu resultat és un altre informe, anomenat Weekly digest seguit del marketplace, i si la IA allotjada no contesta no es crea cap informe. La casella Enable AI insights, desactivada per defecte, és la que marca tot aquest camí.
Preu i ajuda
El mòdul necessita la subscripció a FlexigoTech Cloud, pla Connector: 49 € al mes o 490 € a l'any sense IVA. Aquesta connexió desa xifrades les credencials, vigila la sincronització i avisa per correu si falla. Sense subscripció, o amb el servei suspès, s'atura el que dona la subscripció, i les dades es queden al teu Odoo. Està publicat a Odoo Apps per a 17, 18, 19 i 20 (fitxa, pàgina del mòdul). FlexigoTech implanta Odoo 17, 18, 19 i 20 i desenvolupa connectors i integracions a mida.
Continua llegint
Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades
Fonts
- Codi del mòdul: flexigobe_mirakl_connector 20.0 (aa05e537): views/mirakl_ai_views.xml
- Codi del mòdul: flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_ai.py
- apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
- flexigotech.com/precios.html
- flexigotech.com/en/services.html