Fehlerbehebung

Jede Ablehnung enthält einen Code und einen Satz, der sagt, was zu tun ist. Muss eine Person handeln, enthält sie auch einen Link zur Seite, die das Problem löst.

Ein MCP-Werkzeugergebnis legt den Code in code ab, neben instruction. Auf /p/ kommt ein Fehler als error.code und error.instruction, und die Abfrage eines beendeten, gescheiterten Aufrufs enthält error_code. Die Konsolen-API antwortet mit error.code und error.request_id.

Den Aufruf finden

• Jeder Aufruf hat eine call_id, die mit sp_c_ beginnt. Öffnen Sie https://my.sallyport.cloud/activity?call=<call_id>, um ihn zu sehen.
• Der Aufruf zeigt „Agent“, „Verbindung“, „Schlüsselversion“, „Regel“, „Protokoll“ und einen „Zeitverlauf“ des Geschehens.
• Schreiben Sie über „Einstellungen“, „Support“ mit der call_id und, bei einem Fehler der Konsolen-API, mit deren request_id.

Genau sehen, was der Agent gesendet hat und was zurückkam

Öffnen Sie Aktivität, wählen Sie den Aufruf und klicken Sie auf „Ganze Anfrage und Antwort öffnen“. Der Aufruf steht da, wie er war, ohne verborgene Teile.

• Die Anfrage: Methode, vollständige Adresse, jeder Header und der Body. Bei SSH der Befehl, bei Dateien Pfad und Inhalt, bei einer Datenbank die Anweisung und ihre Werte, bei E-Mail die ganze Nachricht.
• Ein Header, den der Agent an der Stelle des Schlüssels gesendet hat, etwa sein eigenes PRIVATE-TOKEN, bleibt mit seinem Wert in der Liste, durchgestrichen und markiert mit „Durch den Schlüssel der Verbindung ersetzt, nicht gesendet“. Der Schlüssel, den Sallyport eingesetzt hat, erscheint nie.
• Die Antwort: Status, jeder Header und der Body. Eine lange Antwort lädt bis 1 MiB vollständig, und „Vollständige Antwort herunterladen“ speichert sie ganz.
• Anfragen bleiben so lange wie der Aufrufverlauf, standardmäßig 180 Tage. Antworten und Anfrage-Bodys über 1 MiB bleiben 30 Tage, danach sagt der Aufruf das.

Ein Dienst fehlt in den Werkzeugen des Agenten

• Lassen Sie den Agenten list_access aufrufen. Es listet jeden Dienst, den der Agent nutzen darf, und was auf eine Person wartet.
• Ein neuer Schlüssel geht an jeden aktiven Agenten seines Arbeitsbereichs und seiner Umgebung. Ein Agent in Test sieht nie einen Live-Schlüssel.
• Eine aus der Liste „Zugriff“ eines Agenten entfernte Verbindung bleibt entfernt. Holen Sie sie mit „Verbindung hinzufügen“ zurück.
• Ab 40 Werkzeugen verlassen die Werkzeuge entfernter MCP-Server die Liste. Der Agent findet sie mit search_tools und führt sie mit call aus.
• Ein Host außerhalb der Liste funktioniert über http_request. Der erste Aufruf liefert einen Link, unter dem Sie seinen Schlüssel hinzufügen.

Antwortcodes

Wenn der Dienst nicht antwortete

UPSTREAM_ERROR mit einem reason bedeutet, dass keine Antwort zurückkam. side_effect ist none, wenn nichts den Dienst erreicht hat, und unknown, wenn es ihn erreicht haben kann.

Anfragefehler, die eine Person behebt

Die meisten Gründe für BAD_REQUEST behebt der Agent selbst, und der Text sagt ihm, wie. Diese brauchen eine Person:

• not_https mit console_url: Die Adresse der Verbindung beginnt mit http://. Ändern Sie sie auf der Seite der Verbindung in https://.
• mcp_binding, database_binding oder email_binding: Ein Aufruf über /p/ zielt auf einen MCP-Server, eine Datenbank oder ein Postfach. Rufen Sie deren Werkzeuge über den MCP-Endpunkt auf. sftp_operation: Ein Dateiaufruf nennt nicht eindeutig eine Operation; detail sagt, was zu ändern ist.
• missing_host: Die Verbindung deckt alle Hosts eines Dienstes ab, also muss der Aufruf einen nennen. Auf /p/ steht der Host direkt nach der Verbindungs-ID.

Fehler der Konsolen-API

• FORBIDDEN nennt die nötige Rolle in details.required_role. Der Protokollexport braucht einen Inhaber oder einen Administrator oder Auditor der ganzen Organisation ohne engere Rolle in einem Arbeitsbereich.
• Ein API-Schlüssel kann keine Karte beantworten: Eine Entscheidung braucht eine Person.
• VALIDATION_FAILED nennt jedes fehlerhafte Feld in details.fields.
• AUTH_FAILED bedeutet, dass die Sitzung endete oder der API-Schlüssel widerrufen wurde.

Einen Dienstschlüssel ohne Unterbrechung tauschen

• Erstellen Sie beim Anbieter einen neuen Schlüssel, solange der aktuelle noch funktioniert.
• Öffnen Sie den Schlüssel unter Schlüssel, tippen Sie auf „Schlüssel tauschen“, fügen Sie den neuen Wert ein und tippen Sie auf „Neuen Schlüssel speichern“.
• Machen Sie einen Aufruf über Sallyport. Sobald er gelingt, widerrufen Sie den alten Schlüssel beim Anbieter.