Jobs
Erstelle einen vollständigen wiederverwendbaren Job oder hänge eine unveränderliche Patch-Revision auf exakter Basis an.
Der öffentliche Produktions-MCP-Endpoint ist live unter https://mcp.everyn.ai/mcp. Konfiguriere einen Host mit dieser Streamable-HTTP-URL und schließe WorkOS-OAuth ab.
Ein Job ist eine wiederverwendbare Definition: Name, Goal, Instructions, Output-Vertrag, exaktes Model, optionale Capabilities und Display Fields. start_run pinnt eine unveränderliche Job-Version. Es gibt keine Inline-Job-Definition auf start_run.
Nutze search_jobs und get_job, um Arbeit wiederzufinden. get_job liest die aktuelle Version oder eine explizit gewählte Version, einschließlich kompakter Run-Historie.
Erstellen
Rufe save_job mit Name, Goal, Instructions, Output, Model und einem Idempotency Key auf.
Output-mode ist add_columns oder create_rows. Spaltennamen nutzen ^[a-z][a-z0-9_]*$. Unterstützte Spaltentypen sind string, number, integer, boolean, enum, object und array.
Der Model-Wert muss eine exakte, aktuell ausführbare Model-ID aus get_context (include: ["models"]) sein. Rate keinen Model-Namen.
Ein erfolgreiches Receipt liefert die stabile job_id, die exakte job_version_id und die vollständige Effective Definition.
Patch
Um einen Job zu überarbeiten, sende base_version_id, einen Idempotency Key und mindestens ein geändertes Feld.
| Regel | Bedeutung |
|---|---|
| Weggelassene Felder erben | Nicht gesetzte Felder behalten die Basisversion. |
null bedeutet niemals erben | Sende kein null, um „unverändert lassen“ auszudrücken. |
| Leere Arrays löschen | Ein leeres Array ist ein explizites Clear. |
output ist atomar | Wenn gesetzt, wird der gesamte Output-Vertrag ersetzt. |
Wenn die Basis veraltet ist, liefert save_job conflict mit conflict_current_version_id. Lies get_job erneut und patche von der aktuellen Version.
Identische Patches sind sicher: no_op ist true und die Version bewegt sich nicht.
Nächster Schritt
Bevorzuge einen Sample-start_run gegen die neue job_version_id, bevor du einen ungesicherten Full Run startest. Siehe Runs.