Anfrage & Antwort

Dies ist ein Konfigurationsabschnitt von Benutzerdefiniertes MT. Dieser Abschnitt enthält die Kernkonfiguration für Anfragen der Maschinellen Übersetzung.

Variablen

• $ID

• $SOURCE_TEXT oder $ORIGINAL_TEXT

• $TRANSLATED_TEXT

• $SOURCE_LANG

• $TARGET_LANG

Schemavariablen können in der Konfiguration mit der Syntax verwendet werden $SCHEMA_NAME.

Zum Beispiel:

{
    "schema": [
        { "type": "string", "name": "api_key", "title": "API Key", "default": "", "required": true, "message": "Erforderlicher API-Schlüssel" },
    ],
    "request": {
        "method": "http_post",
        "url": "http://127.0.01/?key=$API_KEY"
        "options": {
            "headers": {
              "Authorization": "Bearer $API_KEY",
              "Content-Type": "application/json"
            }
        }        
    }
}

---

Parameter

method: string

• "web_scraping"

• "http_get"

• "http_post"

• "web_llm"

initialUrl: string (optional)

Die anfängliche URL, die besucht wird, bevor die eigentliche Anfrage gestellt wird (für Web-Scraping).

url: string

Die Endpunkt-URL für den Dienst der Maschinellen Übersetzung.

encodeURI: boolean (optional)

Escaped Zeichen unter Verwendung von UTF-8-Codeeinheiten, wobei jedes Oktett im Format %XX, bei Bedarf links mit 0 aufgefüllt wird. Einsame Surrogate in UTF-16 kodieren kein gültiges Unicode-Zeichen. Referenz: encodeURI

encodeURIComponent: boolean (optional)

Verwendet denselben Kodierungsalgorithmus wie encodeURI. Escaped alle Zeichen außer: A–Z a–z 0–9 - _ . ! ~ * ' ( ) Referenz: encodeURIComponent

encodeURIExtra: string (optional)

Zusätzliche Funktion zum Ersetzen von URI mithilfe eines regulären Ausdrucks. Zum Beispiel: ["%2F", "g", "\\%2F"]

userAgent: string (optional)

Benutzerdefinierter User-Agent-String für die HTTP-Anfrage.

querySelector: string

Gibt das erste Element im HTML-Dokument zurück, das dem angegebenen Selektor oder der Gruppe von Selektoren entspricht. Referenz: querySelector

querySelectorAll: string (optional)

Gibt eine statische NodeList zurück, die eine Liste von HTML-Elementen darstellt, die der angegebenen Gruppe von Selektoren entsprechen. Referenz: querySelectorAll

queryProperty: string

Gibt an, welche Eigenschaft aus dem ausgewählten HTML-Element extrahiert werden soll:

• "value" - Eigenschaft des HTMLDataElement [Referenz]

• "innerText" - Eigenschaft des HTMLElement [Referenz]

• "textContent" - Eigenschaft des Node [Referenz]

• "innerHTML" - Eigenschaft des HTMLElement [Referenz]

body: object

Der Anfragekörper für POST-Anfragen. Kann Variablen wie enthalten $SOURCE_TEXT, $SOURCE_LANG, und $TARGET_LANG.

options: object (optional)

Zusätzliche Anforderungsoptionen.

• headers - Benutzerdefinierte Anfrage-Header setzen:

  • X-Custom-Header: string

  • Authorization: string

  • Content-Type: string

responseType: string

• "string" - Antworttyp als string festlegen

• "json" - Antworttyp als json festlegen

responseQuery: string

---

Parsen von JSON-Antworten aus HTTP-Anfragen

JSON-Antworten können mit dem responseQuery Parameter geparst werden.

Der responseQuery Der Parameter wird nur für http_get und http_post Methoden verwendet, wenn der Antworttyp auf json.

Um durch verschachtelte JSON-Objekte zu navigieren, verwenden Sie die Punktnotation (.), um Feldnamen zu trennen. Array-Elemente können mit der Klammernotation und einem Index angesprochen werden (z. B., [0]).

Beispiel JSON-Antwort:

{
  "text": "Hello 1",
  "words": [
    { "text": "Hello 2" },
    { "text": "Hello 3" }
  ]
  "lines": {
    "text": "Hello 4",
    "sub": {
      "text": "Hello 5"
    }        
  }
}

responseQuery	Ergebnis
text	Hello 1
words[0].text	Hello 2
lines.sub.text	Hello 5

---

---

Beispiele

1. Web-Scraping-Methode

Erforderliche Parameter

• method: string ("web_scraping")

• URL: string

• querySelector: string

• queryProperty: string

{
    "request": {
        "method": "web_scraping",
        "encodeURI": false,
        "encodeURIComponent": true, 
        "initialUrl": "https://localhost:8080",
        "url": "https://localhost:8080/?sl=$SOURCE_LANG&tl=$TARGET_LANG&text=$SOURCE_TEXT",    
        "querySelector": "span[lang=$TARGET_LANG]",
        "queryProperty": "innerText"
    }
}

---

2. HTTP-GET-Methode

Erforderliche Parameter

• method: string ("http_get")

• URL: string

• responseType: string

• responseQuery: string

{
    "request": {
        "method": "http_get",
        "encodeURI": false,
        "encodeURIComponent": false, 
        "url": "https://localhost:8080/translate?sl=$SOURCE_LANG&tl=$TARGET_LANG&text=$SOURCE_TEXT",
        "options": {},
        "responseType": "json",
        "responseQuery": "translate.result"
    }
}

---

3. HTTP-POST-Methode

Erforderliche Parameter

• method: string ("http_post")

• URL: string

• body: object

• options: object

  • headers: object

    • X-Custom-Header: string

    • Authorization: string

    • Content-Type: string

• responseType: string

• responseQuery: string

{
    "request": {
        "method": "http_post",
        "encodeURI": false,
        "encodeURIComponent": false, 
        "url": "https://localhost:8080/translate",
        "body": {
            "text": "$SOURCE_TEXT",
            "source_lang": "$SOURCE_LANG",
            "target_lang": "$TARGET_LANG"
        }
        "options": {
            "headers": {
                "Authorization": "Bearer $API_KEY",
                "Content-Type": "application/json"
            }
        },
        "responseType": "json",
        "responseQuery": "translate.result"
    }
}