Agent Veröffentlichen API

​

Bevor du startest

• Veraltete Assistants API: Dies ist die neue Agents API mit nativer Vercel AI SDK Kompatibilität. Wenn du die veraltete Assistants API verwendest, siehe den Migrations-Guide.

​

Basis-URL

https://api.langdock.com/agent/v1/publish

​

Entwurf vs. veröffentlichte Version

​

Anwendungsfälle

• Entwurfsänderungen über die Update-API in eine neue aktive Version überführen
• Änderungen programmatisch ausrollen als Teil einer CI/CD-Pipeline
• Neue Revision veröffentlichen mit optionaler Änderungsbeschreibung in der Versionshistorie

​

Parameter

​

Beispiel

const axios = require("axios");

async function publishAgent(agentId, description) {
  const response = await axios.post(
    "https://api.langdock.com/agent/v1/publish",
    {
      agentId: agentId,
      description: description,
    },
    {
      headers: {
        Authorization: "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
    },
  );

  console.log("Veröffentlichte Version:", response.data.version);
}

publishAgent(
  "550e8400-e29b-41d4-a716-446655440000",
  "System-Prompt geschärft",
);

​

Antwort-Format

​

Erfolgreiche Antwort (200 OK)

{
  status: "success";
  message: "Agent published successfully";
  version: {
    id: string;          // UUID der neuen Version
    version: number;     // Monoton steigende Versionsnummer
    createdAt: string;   // ISO 8601 Zeitstempel
  };
}

​

Validierungsregeln

• Agenten-Zugriff — Ein persönlicher API-Schlüssel kann den Agenten veröffentlichen, wenn sein Besitzer den Agenten bearbeiten kann, auch über eine Gruppe oder den Workspace, oder wenn der Schlüssel eine Editor- oder Besitzerfreigabe hat. Ein Workspace-API-Schlüssel braucht diese Freigabe auf dem Schlüssel.
• Workspace-Übereinstimmung — Der Agent muss zum selben Workspace gehören wie der API-Schlüssel.
• Nur Agenten — Projekte (type=PROJECT) werden nicht unterstützt und liefern 403.
• Entwurfsänderungen erforderlich — Der Entwurf muss sich von der zuletzt veröffentlichten Version unterscheiden. Ein Aufruf ohne ausstehende Änderungen liefert 409 Conflict und spiegelt damit den deaktivierten “Update”-Button in der UI wider.

​

Fehlerbehandlung