🛠️ Conversation Tool Trigger

Il-Conversation Tool Trigger jippermetti lill-agenti tal-AI fi SmartFlow biex jinteraġixxu b'mod dinamiċi ma' għodod u sistemi esterni, jagħmlu deċiżjonijiet intelliġenti biex iwettqu kompiti, jiksbu data, jew jikkawżaw azzjonijiet sussegwenti. Billi juża AI decision engine, l-agenti jiddeċiedu liema għodod għandhom jużaw u jimmassimizzaw l-azzjonijiet multipli b'mod effiċjenti. Dan is-sistema tappoġġa sa 10 azzjonijiet tal-għodod għal kull interazzjoni qabel toffri risposta.

---

📝 Trigger Details

Isem: Conversation Tool
Kategorija: Triggers

---

🔧 Parameters

1. Isem tal-Għodda

   • Tip: string
   • Deskrizzjoni: Speċifika l-għodda li għandha tiġi eżegwita mill-agent tal-AI. L-għodda trid tkun prekonfigurata u integrata fi SmartFlow.
   • Meħtieġ: Iva
   • Eżempju: "CRM Lookup"

2. Variabbli ta' Input

   • Tip: object
   • Deskrizzjoni: Id-data meħtieġa biex l-għodda twettaq il-kompitu tagħha, spiss derivata mill-kuntest tal-fluss tax-xogħol jew tal-konversazzjoni.
   • Meħtieġ: Iva
   • Eżempju:

     {
       "customerId": "12345"
     }

3. Osservazzjoni

   • Tip: string (default: Output speċifiku tal-għodda)
   • Deskrizzjoni: Ir-riżultat tal-azzjoni, li jista' jaffettwa l-imġieba sussegwenti tal-AI. B'mod predefinit, l-osservazzjoni hija stabbilita għall-output tal-għodda, iżda tista' tiġi definiti b'mod manwali biex gwida l-azzjoni li jmiss tal-agent.
   • Eżempju:
     • Osservazzjoni Predefinita: Riżultat tal-API li ġie rritornat mill-għodda.
     • Osservazzjoni Personalizzata: "Itriggerja l-formola li jmiss ibbażata fuq il-preferenzi tal-utent."

---

🚀 Kif Jaħdem

1. Osservazzjonijiet Default:

   • Kull azzjoni tal-għodda ġġenera osservazzjoni default ibbażata fuq ir-riżultat tal-għodda.
   • Eżempju: Telefonata API suċċessiva tirritorna r-risposta tal-API bħala l-osservazzjoni.

2. Impostazzjoni Manwali tal-Ossservazzjoni:

   • L-utenti jistgħu jissostitwixxu l-osservazzjoni default biex jaffettwaw id-deċiżjoni li jmiss tal-AI.
   • Eżempju: Minflok tuża r-riżultat tal-API bħala l-osservazzjoni, messaġġ personalizzat bħal "Start form submission process" jista' jwassal lill-AI biex jibda azzjoni oħra.

3. Motur ta' Deċiżjoni tal-AI:

   • Il-mutur tad-deċiżjoni janalizza l-osservazzjoni attwali u jiddetermina l-azzjoni tal-għodda li jmiss, billi jikkatina b'mod bla xkiel diversi għodod meta jkun meħtieġ.

4. Formulazzjoni ta' Risposta:

   • Wara li jeżegwixxi sa 10 azzjonijiet tal-għodda, l-agent tal-AI jifformula risposta, kemm direttament billi juża l-osservazzjonijiet jew ibbażat fuq input addizzjonali mill-utent.

---

💡 Każijiet ta' Użu

1. Appoġġ Dinamiku għall-Klijent:

   • Sena: Utent jistaqsi, "Nista' nikseb aġġornament dwar l-ordni riċenti tiegħi?"
   • Fluss ta' Xogħol:
     • Għodda: Telefonata API biex tiġi ġġenerata d-dettalji tal-ordni.
     • Osservazzjoni: Riżultat tal-API bil-istatus tal-ordni.
     • Risposta: "L-ordni tiegħek hija fit-triq u se tasal fid-15 ta' Jannar, 2025."

2. Direzzjoni ta' Fluss ta' Xogħol Personalizzat:

   • Sena: Utent jikkawża għodda, iżda tixtieq li l-AI tibda forma speċifika minflok.
   • Fluss ta' Xogħol:
     • Għodda: "Form Starter."
     • Osservazzjoni: "Initiate User Feedback Form."
     • Riżultat: L-AI timxi dinamiċament lejn sottomissjoni tal-forma.

3. Integrazjoni Multi-Passi:

   • Sena: "Kemm hu l-invoice attwali tiegħi, u nista' nħallsu issa?"
   • Fluss ta' Xogħol:
     • Pass 1: Iġbor id-dettalji tal-invoice permezz tal-API.
     • Pass 2: Ikkawża l-gateway tal-ħlas.
     • L-osservazzjonijiet jiggwidaw is-sekwenza ta' dawn l-azzjonijiet.

---

🔍 Eżempju ta' Konfigurazzjoni

Osservazzjoni Default

Isem tal-Għodda: "Order Management"
Variabbli ta' Input:

{
  "orderId": "67890"
}

Osservazzjoni: API result

{
  "trigger": "ConversationTool",
  "toolName": "Order Management",
  "input": {
    "orderId": "67890"
  },
  "observation": "Order status fetched successfully."
}

Osservazzjoni Personalizzata

Isem tal-Għodda: "Start Form"
Variabbli ta' Input:

{
  "formId": "feedbackForm"
}

Osservazzjoni: "User feedback form initiated."

{
  "trigger": "ConversationTool",
  "toolName": "Start Form",
  "input": {
    "formId": "feedbackForm"
  },
  "observation": "User feedback form initiated."
}

---

🛠️ Aħjar Prattiċi

1. Osservazzjonijiet Default vs. Personalizzati:

   • Uża osservazzjonijiet default għal flussi ta' xogħol standard u integrazjonijiet tal-API.
   • Override osservazzjonijiet biex iddawwar il-kondotta tal-AI għal scenarji speċifiċi.

2. Messaġġi ta' Osservazzjoni Ċari:

   • Assigura li l-osservazzjonijiet personalizzati jkunu preċiżi biex gwidaw l-AI b'mod effettiv.

3. Katin ta' Azzjonijiet:

   • Ippjana flussi ta' xogħol biex inaqqsu passi mhux meħtieġa filwaqt li jutilizzaw b'mod effiċjenti l-limitu ta' 10 azzjonijiet.

4. Testjar ta' Osservazzjonijiet:

   • Simula flussi ta' xogħol biex tiżgura li kemm l-osservazzjonijiet default kif ukoll dawk personalizzati jwasslu għal deċiżjonijiet mistenni tal-AI.

---

📊 Monitoraġġ u Debugging

• Uża l-SmartFlow monitoring dashboard biex traċċa:
  • Azzjonijiet tal-għodda eżegwiti.
  • Osservazzjonijiet ġġenerati.
  • Deċiżjonijiet tal-AI u l-konsegwenzi tagħhom.
• Debug flussi ta' xogħol billi reviżjoni tal-logs tal-osservazzjoni biex tidentifika u tirriżolvi kondotta mhux mistenni.