Zum Hauptinhalt springen

Agenten-Prüfablauf ausführen

Verbinden Sie einen Agenten mit einer Workspace-Prüfrichtlinie und fordern Sie Prüfungen von den Personen an, die Ihr Workspace einlädt.

Agenten starten mit der Prüfung durch die Bewertungs-KI, wenn der Eigentümer sie verbindet; laden Sie Prüfende ein, wenn Menschen entscheiden sollen. Ihre Bewertungen sind beratend, von menschlichen Prüfanfragen getrennt und erfüllen keine vorgeschriebene menschliche Prüfung. Unterstützte KI-Aufgaben.

Jetzt verfügbar

Nutzen Sie das geschützte Workspace-MCP, um geeignete Ausgaben zu bewerten, bei Bedarf eine Prüfung anzufordern, auf denselben Vorgang zu warten und dessen Ergebnis zu lesen.

Agenten verbinden

Verbundene Workspace-Prüfung

Das Workspace-MCP unter https://www.rateloop.ai/api/agent/v1/mcp bindet eine zugelassene Agentenversion an ihre vom Eigentümer freigegebene Prüfrichtlinie. Eine sichere Verbindung kann diesen Kontext lesen und Prüfungsanforderungen bewerten, aber keine privaten Artefakte lesen oder den Workspace verwalten.

  1. Rufen Sie rateloop_get_agent_context, dann rateloop_verify_connection.
  2. Rufen Sie vor jeder geeigneten Ausgabe rateloop_evaluate_review_requirement mit datenschutzgerechten Ausführungsmetadaten auf.
  3. Ist eine Prüfung erforderlich, rufen Sie rateloop_request_review, dann rateloop_wait_for_review und rateloop_get_review_result auf, bevor der Host die Ausgabe freigibt.
  4. Rufen Sie rateloop_get_assurance_state auf, wenn Sie aktuelle Belege zu Abdeckung und Übereinstimmung benötigen.
  5. Rufen Sie rateloop_get_model_guidance vor Arbeitsbeginn auf, um zu sehen, welches Modell den Prüfstandard des Inhabers für jeden Ablauf erfüllt hat. Das ist eine Entscheidungshilfe aus menschlichen Prüfungen, keine Prüfung.

Wenn die Bewertungs-KI aktiviert ist

Dieser Weg unterstützt eigene binäre Bewertungen englischer oder deutscher Texte mit der gespeicherten Frage und den Antwortbezeichnungen der verantwortlichen Person. Eine ausdrückliche KI-Verarbeitungserlaubnis und ein kompatibler Evaluator sind erforderlich. Für Workflows mit primärer KI-Bewertung ist Training optional. Überschreiben Sie die gespeicherte Frage oder die Antwortbezeichnungen nicht.

Bei vollständiger menschlicher Prüfung sind auch optionale verblindete KI-Vergleiche möglich, wenn privates Lernen unter Verbessern aktiviert ist. KI-Ergebnisse bleiben bis zum Abschluss der menschlichen Prüfung verborgen. Diese Vergleiche nutzen das bestehende KI-Kontingent und erzeugen keine zusätzlichen menschlichen Prüfaufträge.

Wenn selection.ratingAi.enabled wahr ist, übermitteln Sie den exakten Text an den autorisierten Evaluator. Wählen Sie optionalen Kontext oder Referenzmaterial sowie den erforderlichen zu bewertenden Text. Verwenden Sie eine leere Kontextzeichenfolge, wenn kein Kontext nötig ist. Bilden Sie die Hashes dieser exakten UTF-8-Zeichenfolgen für sourceEvidence.hash und suggestionCommitment, und übermitteln Sie dieselben Texte in ratingInput beim Aufruf von rateloop_evaluate_review_requirement:

ratingInput: {
  language: "en", // or "de"; match the owner's saved question language
  sourcePayload: contextOrReference ?? "",
  suggestionPayload: textToEvaluate,
}

Lassen Sie ratingInput weg, wenn selection.ratingAi.enabled nicht wahr ist. Bei Workflows mit primärer KI-Bewertung führen fehlende Erlaubnis, ein nicht verfügbares kompatibles Modell, fehlender Text oder nicht passende Commitments zu einem Fehler, nicht zu einer abgeschlossenen Bewertung. Bei vollständiger menschlicher Prüfung wird der optionale Vergleich bei nicht verfügbarer KI oder fehlendem Vergleichstext übersprungen; die menschliche Prüfung wird fortgesetzt. Ein Richtlinienergebnis review_not_required kann dennoch einen ausstehenden ratingAi Auftrag enthalten. Verwenden Sie dessen opportunityId mit rateloop_get_rating_ai_result.

  • Nur KI: Prüfen Sie ausstehende oder laufende Aufträge in begrenzten Abständen. Melden Sie das Ergebnis der verantwortlichen Person als Hinweis, niemals als menschliche Freigabe; erzeugen Sie bei Nur KI keinen menschlichen Ersatzpfad.
  • KI + Mensch: durchlaufen Sie rateloop_request_review, rateloop_wait_for_review, und rateloop_get_review_result. Ein ausgewählter verblindeter KI-Vergleich bleibt bis zum menschlichen Prüfergebnis verborgen. KI kann eine vorgeschriebene menschliche Prüfung nicht ersetzen.
  • Nur Menschen: Es entsteht kein KI-Auftrag. Folgen Sie der Entscheidung und dem Ergebnis der menschlichen Prüfung.
  • Offline, fehlgeschlagen, abgebrochen oder unsicher: Ausstehende Arbeit kann auf den autorisierten lokalen Evaluator warten. Prüfen Sie denselben Auftrag erneut; melden Sie einen endgültigen Fehler oder Unsicherheit ausdrücklich ohne KI-Freigabe und lassen Sie die verantwortliche Person entscheiden. Ein nicht verfügbares KI-Ergebnis ist keine menschliche Freigabe.

Größenlimits

Menschliche Prüfung akzeptiert bis zu 131.072 Zeichen pro Feld. Jede vollständig serialisierte MCP-Anfrage muss außerdem in 65.536 UTF-8-Bytes (64 KiB) passen, einschließlich beider Felder, JSON-Escaping und Anfragehülle. Prüfen Sie vor dem Anlegen eines Vorgangs die Größe der Auswertung und der späteren Prüfanfrage. Verwenden Sie den exakten Text der gespeicherten Hashes erneut; übertragen Sie die Bewertung einer Zusammenfassung niemals auf eine längere Antwort.

Die Bewertungs-KI unterstützt höchstens 3.000 Zeichen pro Feld sowie die Token-Grenze des Modells. Längeres Material innerhalb der Grenzen für menschliche Prüfung und Übertragung liefert den KI-Status unavailable mit rating_input_too_long und ohne KI-Auftrag. Die menschliche Prüfung folgt weiterhin der Richtlinie des Eigentümers im selben Vorgang und auf derselben Karte. Überspringen Sie sie nicht wegen der KI-Längengrenze, erstellen Sie keine zusätzliche Prüfung und ergänzen Sie keine menschliche Ersatzprüfung bei einer reinen KI-Richtlinie.

MCP-Anbindungen unterstützen den Prüfablauf: Der Agent muss die Prüfwerkzeuge aufrufen; Ihr Ablauf bestimmt, wann das Ergebnis ausgeliefert wird.

Mit Codex verbinden

Öffnen Sie Verbindungen, wählen Sie Codex desktop und kopieren Sie dessen Verbindungsnachricht. Sie nennt RateLoop Workspace, damit Codex es verwenden kann, wenn das Plugin bereits im nativen Inventar des Hosts verfügbar ist. RateLoop veröffentlicht derzeit keinen öffentlichen Plugin-Marketplace und keine Repository-Installationsquelle. Wenn Codex keine native Plugin-Aktion anbietet, melden Sie die Host-Blockade, statt eine Repository-Installation zu versuchen.

Die kopierte Nachricht zielt auf rateloop-workspace@rateloop. Wenn Codex diesen bereits verfügbaren Inventareintrag installiert, stehen seine Fähigkeiten und Werkzeuge in genau einer neuen Codex-Aufgabe zur Verfügung. Ein bereits geladenes Plugin kann nach OAuth in derselben Aufgabe fortfahren.

Plugin installiert, aber die Werkzeuge fehlen?

  • Wird das Plugin während der aktuellen Aufgabe installiert, starten Sie genau eine neue Codex-Aufgabe und fügen Sie dieselbe Verbindungsnachricht einmal ein, solange ihre URL noch nicht beansprucht wurde.
  • Schließt ein bereits geladenes Plugin die native OAuth-Autorisierung vor einer Beanspruchung ab, fahren Sie in derselben Aufgabe fort und fügen Sie die Nachricht nicht erneut ein.
  • Stoppen Sie nach invalid_grant alle RateLoop-Aufrufe, verwenden Sie die alte Verbindungs-URL nie wieder, stellen Sie die Autorisierung nur über das vom Host angezeigte Plugin-OAuth wieder her und fügen Sie anschließend genau eine neue gezielte Wiederverbindungsnachricht in eine neue Aufgabe ein.
  • Schließen Sie die Quellbestätigung der Wiederverbindung und die Freigabe durch den Eigentümer in der Aufgabe ab, die die neue Wiederverbindungsnachricht enthält; fügen Sie sie nicht erneut ein.
  • Nach der Verifizierung finden zukünftige Aufgaben die Verbindung über rateloop_get_agent_context wieder und benötigen die Verbindungsnachricht nicht.
  • Eine aktive RateLoop-OAuth-Freigabe erneuert kurzlebige Zugriffe aufgabenübergreifend bis zu 90 Tage lang; eine ältere Aufgabe darf diese Freigabe niemals widerrufen.

Eine verifizierte OAuth-Freigabe funktioniert aufgabenübergreifend und erneuert kurzlebige Zugriffsberechtigungen automatisch, solange sie aktiv ist. Eine neue Autorisierung ist erforderlich, wenn die Freigabe abläuft oder widerrufen wird, der Workspace gelöscht wurde oder Codex einen veralteten Berechtigungsnachweis wiederherstellt. Folgen Sie nur einer OAuth-Aktion, die der Plugin-Host anzeigt. Zeigt Codex keine an, melden Sie die Host-Blockade; eine eigenständige MCP-An- oder -Abmeldung repariert die Plugin-Authentifizierung nicht.

Eine eigenständige MCP-Registrierung namens rateloop-workspace darf nicht gleichzeitig mit dem RateLoop-Workspace-Plugin bestehen. Fehlen die geschützten Werkzeuge auch in einer neuen Aufgabe nach der Installation, prüfen Sie einmal das native Plugin-Inventar; installieren Sie ein aktiviertes Plugin nicht erneut.

Weitere MCP-Clients und Unterstützungsstufen

MCP-Kompatibilität hängt vom Host und Agentenablauf ab, nicht von der Modellmarke. Das Modell benötigt Werkzeugnutzung; der Host muss entferntes Streamable HTTP, OAuth, Werkzeugergebnisse und den Sitzungslebenszyklus implementieren.

Codex Desktop ist ein unterstützter Verbindungspfad. Andere Clients benötigen einen eigenen Release-Smoke-Test auf dem installierten Host, bevor eine benannte Version als releasegetestet gelten kann.

Nutzen Sie die hostspezifische Einrichtungs- und Unterstützungsmatrix für die aktuellen Transport- und Authentifizierungsanforderungen.

Wenn ein Aufruf abgelehnt wird

Jeder Fehlschlag liefert denselben Umschlag zurück, und ob ein Agent es erneut versuchen soll, steht in der Antwort, statt aus dem Statuscode abgeleitet zu werden. API-Fehler führt jeden Code auf, wodurch er entsteht und welche wiederholbar sind.

Entscheidungsgrenze

RateLoop liefert Belege menschlicher Prüfung und offengelegte Grenzen; es erteilt keine automatische Produktions-, Sicherheits-, Rechts-, Medizin- oder Compliance-Freigabe. Verwenden Sie nur autorisiertes, minimiertes Material und lassen Sie eine verantwortliche Person für jede Rollout-Entscheidung zuständig.

Leitfaden zur Agentenintegration | RateLoop