> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agents API Übersicht

> Erstelle, verwalte und chatte mit Agenten in deinem Langdock Workspace programmatisch

Mit der Agents API erstellst, verwaltest und chattest du programmatisch mit Agenten in deinem Langdock Workspace. Der Completions-Endpoint verwendet das Vercel AI SDK kompatible Nachrichtenformat, sodass du Agenten mit dem `useChat` Hook und anderen Vercel AI SDK Features nutzen kannst.

## Bevor du startest

* **API-Key-Scope**: Agenten-Endpoints erfordern einen API-Schlüssel mit dem `AGENT_API` Scope. Die Attachment-Endpoints erfordern den `KNOWLEDGE_FOLDER_API` Scope.
* **Agenten-Zugriff**: Um einen bestehenden Agenten mit einem API-Schlüssel zu nutzen, muss der Agent mit diesem Schlüssel geteilt sein. Siehe [Agenten mit API-Schlüsseln teilen](/de/developer/agents-api/agent-api-guide).
* **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](/de/developer/assistants-api/assistant-to-agent-migration).

## Basis-URL

```
https://api.langdock.com
```

<Warning>
  **Dedicated Deployments**

  Ersetze `api.langdock.com` durch `<your-deployment-url>/api/public` in allen Anfragen.
</Warning>

## Verfügbare Endpoints

### Agenten

| Methode | Endpoint                     | Beschreibung                                                                    |
| ------- | ---------------------------- | ------------------------------------------------------------------------------- |
| `POST`  | `/agent/v1/chat/completions` | [Modellantwort für einen Agenten erstellen](/de/developer/agents-api/agent)     |
| `GET`   | `/agent/v1/get`              | [Agenten-Details abrufen](/de/developer/agents-api/agent-get)                   |
| `POST`  | `/agent/v1/create`           | [Neuen Agenten erstellen](/de/developer/agents-api/agent-create)                |
| `PATCH` | `/agent/v1/update`           | [Agenten aktualisieren](/de/developer/agents-api/agent-update)                  |
| `POST`  | `/agent/v1/publish`          | [Entwurf eines Agenten veröffentlichen](/de/developer/agents-api/agent-publish) |
| `PATCH` | `/agent/v1/disable`          | [Agenten aktivieren oder deaktivieren](/de/developer/agents-api/agent-disable)  |
| `GET`   | `/agent/v1/models`           | [Verfügbare Modelle auflisten](/de/developer/agents-api/agent-models)           |

### Attachments

| Methode  | Endpoint                | Beschreibung                                                                    |
| -------- | ----------------------- | ------------------------------------------------------------------------------- |
| `POST`   | `/attachment/v1/upload` | [Dateien für Agenten hochladen](/de/developer/agents-api/upload-attachments)    |
| `DELETE` | `/attachment/v1/delete` | [Hochgeladenes Attachment löschen](/de/developer/agents-api/delete-attachments) |

## Guides

* [Agenten mit API-Schlüsseln teilen](/de/developer/agents-api/agent-api-guide): erstelle einen API-Schlüssel und teile einen Agenten mit ihm
* [Agent Migrations-Guide](/de/developer/agents-api/agent-migration): migriere Agenten zwischen Workspaces mit der Agents API