Im Coze-Workflow, wenn 'ungültiges Zeichen' gemeldet wird, wird 'ungültiges Zeichen' gemeldet<' looking for beginning of value`，很多人第一反应是模型坏了，其实大概率不是。公开 issue 里，这种错误通常意味着接口本来应该返回 JSON，结果却返回了一个网页，比如 404 页面、登录页，或者反向代理吐出来的 HTML。换句话说，程序在等数据，却收到了网页。
Wenn du dir die offizielle Open-Source-Version ansiehst, lautet die Repository-Adresse immer noch coze-dev/coze-studio. Die offiziellen README- und Entwicklungsnotizen betonen, dass Modellkonfigurationen, API-Einträge und Workflow-Ausführungsumgebungen zuerst abgestimmt werden müssen, sonst explodieren sie am ehesten zur Laufzeit.
Warum dieser Fehler einem "Modellproblem" sehr ähnlich ist
Weil es oft auftritt, wenn ein Workflow-Knoten läuft und der Knoten zufällig ein Modell oder eine externe Schnittstelle aufruft. Aber das eigentliche Fehler-Schlüsselwort ist ""<`'，这说明返回内容开头是 HTML 标签而不是 JSON。也就是说，你要查的不是“模型会不会说话”，而是“接口到底回了什么”。
Die häufigsten Gründe
- Die Basis-URL ist nicht übereinstimmend, und die Schnittstelle erreicht tatsächlich die Webseite statt der API.
- Der Pfad fehlt '/v1' oder eine zusätzliche Proxy-Schicht, wodurch die Anfrage an die falsche Adresse weitergeleitet wird.
- Das Gateway oder Nginx liefert eine Fehlerseite, aber das Frontend parst sie als Schnittstellenantwort.
Gebräuchlich verwendete Untersuchungsmethoden in der Gemeinschaft
Am effektivsten ist es nicht, zu raten, sondern direkt auf die tatsächliche Reaktion zu schauen. Du kannst 'curl' oder das Browser-Webpanel verwenden, um zu prüfen, ob die Benutzeroberfläche JSON zurückgibt. Wenn es von Anfang an HTML ist, ist das Problem im Grunde im Adress-, Proxy- und Authentifizierungssprung festgelegt. Im offenen Fall hatte jemand eine ähnliche Situation und stellte schließlich fest, dass der Anfragepfad der Drittanbieter-OpenAPI nicht übereinstimmte oder die Proxy-Schicht den Inhalt der Webseite zurückgab.
Wenn Sie Schritt für Schritt einen Workflow erstellen, wird empfohlen, zunächst eine Schnittstelle zu verwenden, die bestätigt, dass es kein Problem gibt, einen Mindesttest durchzuführen, und dann langsam weitere Knoten wieder hinzuzufügen. So können Sie, sobald ein Fehler gemeldet wird, schnell erkennen, welche Ebene JSON in HTML umgewandelt hat.
Ein-Satz-Schluss
'Ungültiger Charakter'<'` 不是“模型语法错误”，而是接口响应不对。先查地址、代理和返回内容，往往比改工作流节点更快。
