Eigene Code-Ausführung

​

Mit Charlie erstellen

​

Code schreiben

export async function run({
  inputs,
  credentials,
  timeoutMs,
}) {
  const { token } = credentials.orders;
  const id = encodeURIComponent(inputs.orderId);
  const url = `https://api.example.com/orders/${id}`;
  const response = await fetch(url, {
    headers: { Authorization: `Bearer ${token}` },
    signal: AbortSignal.timeout(timeoutMs - 500),
  });
  if (response.status === 404) {
    return { found: false };
  }
  if (!response.ok) {
    throw new Error(
      `Order lookup failed (${response.status}). ` +
        "Tell the caller to try later.",
    );
  }
  const order = await response.json();
  return { found: true, status: order.status };
}

• Er kann Standard-Web-APIs nutzen, zum Beispiel fetch, URL, URLSearchParams, Headers, AbortSignal, TextEncoder, TextDecoder, crypto.subtle, crypto.randomUUID, atob und btoa. Anfragen erreichen jede öffentliche Adresse.
• Er kann keine npm-Pakete oder anderen Module importieren.
• Die Uhr läuft in UTC. Übergib beim Formatieren von Datumswerten timeZone an Intl.DateTimeFormat.
• Variablen auf oberster Ebene können aus einer früheren Ausführung desselben Codes erhalten bleiben, aber auch jederzeit neu beginnen. Halte Werte, die sich ändern, innerhalb von run.
• Ausgaben von console.log werden nirgends angezeigt. Gib zurück oder wirf, was du sehen musst.

​

Limits

​

Code-Tool hinzufügen

1. Öffne den Agenten und gehe zu Tools → Code-Tools. Wähle Code-Tool hinzufügen….
2. Schreibe den Code links im Editor Code.
3. Lege im Tab Konfigurieren fest:

   Feld	Beschreibung
   Name des Tools	Bezeichner, den der Agent aufruft, zum Beispiel check_order_status. Beginnt mit einem Buchstaben, danach Buchstaben, Zahlen und Unterstriche, bis zu 64 Zeichen
   Beschreibung	Was das Tool tut und wann der Agent es verwenden soll
   Eingaben	Werte, die der Code aus inputs liest. Sie nutzen dieselben Werttypen wie Custom HTTP Tools. Nur Eingaben vom Typ LLM-Parameter füllt der Agent aus dem Gespräch
   Zugangsdaten	Zugangsdaten, die der Code aus credentials liest. Siehe Geheimnisse und Zugangsdaten
   Antwort-Timeout (Sekunden)	Wie lange der Code laufen darf. Standard sind 5 Sekunden, höchstens 10, mit einer Tool-Nachricht bis zu 30
   Tool-Nachricht	Was der Agent sagt, während der Code läuft

4. Wähle Fertig und veröffentliche den Agenten. Erwähne das Tool im Prompt, wenn der Agent es nur unter bestimmten Bedingungen verwenden soll.

​

Code-Tool testen

​

Wenn ein Code-Tool im Anruf fehlschlägt

​

Code-Block hinzufügen

1. Nutze im Workflow-Editor + auf der Zeichenfläche und wähle Dienstprogramme → Code.
2. Wähle unter Eingaben Eingabe hinzufügen. Gib jeder Eingabe einen Namen und ordne ihr Workflow-Daten, einen festen Wert oder ein Geheimnis zu.
3. Füge unter Zugangsdaten die Zugangsdaten hinzu, die der Code braucht.
4. Schreibe den Code im Editor JavaScript. Gib ein JSON-Objekt zurück.
5. Wähle in der Feldauswahl eines späteren Blocks result des Code-Blocks oder eines seiner Felder.

​

Code-Block testen

​

Wenn ein Code-Block fehlschlägt

​

Geheimnisse und Zugangsdaten

• Geheime Eingabe: Füge eine Eingabe vom Typ Geheim hinzu. Der Wert wird beim Speichern verschlüsselt, und der Code liest ihn wie jede andere Eingabe.
• Zugangsdaten: Wähle unter Zugangsdaten + Hinzufügen und wähle Zugangsdaten aus Einstellungen → Entwickler oder deine Salesforce- oder HubSpot-Verbindung aus Einstellungen → Integrationen. Gib ihnen einen Namen; der Code liest sie als credentials.<name>.