🛠️ Conversation Tool Trigger

De Conversation Tool Trigger erlaabt AI-Agenten innerhalb SmartFlow, dynamesch mat externen Tools a Systemer ze interagéieren, intelligent Entscheedungen ze treffen fir Aufgaben aus ze féieren, Daten ze recuperéieren oder folgend Aktiounen ze starten. Mat engem AI decision engine entscheedéieren d'Agenten, wéi eng Tools ze benotzen an verwalten multipel Aktiounen effizient. Dës System ënnerstëtzt bis zu 10 Tool-Aktiounen pro Interaktioun ier et eng Äntwert gëtt.

---

📝 Trigger Details

Numm: Conversation Tool
Kategorie: Triggers

---

🔧 Parameteren

1. Tool Numm

   • Typ: string
   • Beschreiwung: Gëtt d'Tool un, dat vum AI-Agent ausgefouert soll ginn. D'Tool muss virunhand konfiguréiert an an SmartFlow integréiert sinn.
   • Required: Jo
   • Beispill: "CRM Lookup"

2. Input Variabelen

   • Typ: object
   • Beschreiwung: D'Daten, déi néideg sinn fir d'Tool seng Aufgab ze erfëllen, oft aus dem Kontext vum Workflow oder der Konversatioun ofgeleet.
   • Required: Jo
   • Beispill:

     {
       "customerId": "12345"
     }

3. Observatioun

   • Typ: string (standard: Tool-spezifesch Ausgabe)
   • Beschreiwung: D'Resultat vun der Aktioun, wat d'nächste AI-Verhalen beaflosse kann. Standardméisseg ass d'Observatioun op d'Ausgabe vum Tool gesat, awer et kann manuell definéiert ginn fir d'Aktioun vum Agent ze leeden.
   • Beispill:
     • Standard Observatioun: API Resultat dat vum Tool zréckginn.
     • Benotzerdefinéiert Observatioun: "Trigger the next form based on user preferences."

---

🚀 Wéi et funktionnéiert

1. Standard Observatiounen:

   • Jidderee Tool-Aktioun generéiert eng standard Observatioun baséiert op der Resultat vum Tool.
   • Beispill: Eng erfollegräich API-Call gëtt d'API-Antwort als Observatioun zréck.

2. Manuell Observatiounssetzung:

   • Benotzer kënnen d'standard Observatioun iwwerhuelen fir d'AI seng nächst Entscheedung ze beaflossen.
   • Beispill: Amplaz d'API Resultat als Observatioun ze benotzen, kann eng benotzerdefinéiert Message wéi "Start form submission process" d'AI leeden fir eng aner Aktioun ze starten.

3. AI Decision Engine:

   • D'Entscheedungsmaschinn analyséiert d'aktuell Observatioun an bestëmmt d'nächste Tool-Aktioun, nahtlos multipel Tools ze verknëppelen wann néideg.

4. Äntwertformulatioun:

   • No der Ausféierung vun bis zu 10 Tool-Aktiounen formuléiert de AI-Agent eng Äntwert, entweder direkt mat den Observatiounen oder baséiert op zousätzleche Input vum Benotzer.

---

💡 Benotzungsfäll

1. Dynamesch Client Support:

   • Szenario: E Benotzer freet, "Kann ech eng Aktualiséierung iwwer mengem kierzlechen Uerdnung kréien?"
   • Workflow:
     • Tool: API Call fir Uerdnung Detailer ze kréien.
     • Observatioun: API Resultat mat Uerdnungsstatus.
     • Äntwert: "Är Uerdnung ass op der Strooss an wäert den 15. Januar 2025 ukommen."

2. Benotzerdefinéiert Workflow Ëmleitung:

   • Szenario: E Benotzer start e Tool, awer Dir wëllt d'AI eng spezifesch Form starten.
   • Workflow:
     • Tool: "Form Starter."
     • Observatioun: "Initiate User Feedback Form."
     • Resultat: D'AI wechselt dynamesch op d'Formulär-Afuerderung.

3. Multi-Step Integratioun:

   • Szenario: "Wéi vill ass meng aktuell Rechnung, a kann ech et elo bezuelen?"
   • Workflow:
     • Schrëtt 1: Rechnungsdetailer via API recuperéieren.
     • Schrëtt 2: D'Zuelungs-Gateway starten.
     • Observatiounen leeden d'Rei vun dësen Aktiounen.

---

🔍 Beispill Konfiguratioun

Standard Observatioun

Tool Numm: "Order Management"
Input Variabelen:

{
  "orderId": "67890"
}

Observatioun: API result

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

Benotzerdefinéiert Observatioun

Tool Numm: "Start Form"
Input Variabelen:

{
  "formId": "feedbackForm"
}

Observatioun: "User feedback form initiated."

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

---

🛠️ Bescht Praktiken

1. Standard vs. Benotzerdefinéiert Observatiounen:

   • Benotzt standard Observatiounen fir standard Workflows an API Integratiounen.
   • Iwwerschreift Observatiounen fir d'AI-Verhalen fir spezifesch Szenarien ze leeden.

2. Kloer Observatiounsmessagen:

   • Stellt sécher, datt benotzerdefinéiert Observatiounen präzis sinn fir d'AI effektiv ze leeden.

3. Verknëppelen Aktiounen:

   • Plangt Workflows fir onnéideg Schrëtt ze minimiséieren während Dir d'10-Aktiounslimit effizient benotzt.

4. Testen Observatiounen:

   • Simuléiert Workflows fir ze veriféieren, datt souwuel standard wéi och benotzerdefinéiert Observatiounen zu erwaarten AI-Entscheedungen féieren.

---

📊 Iwwerwaachung an Debugging

• Benotzt den SmartFlow Iwwerwaachungsdashboard fir ze verfollegen:
  • Tool-Aktiounen ausgefouert.
  • Observatiounen generéiert.
  • AI-Entscheedungen an hir Resultater.
• Debugging Workflows duerch d'Observatiounslogs ze iwwerpréiwen fir ongewollt Verhalen ze identifizéieren an ze léisen.