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

# Tool-Referenz

> Alle MCP-Tools, ihre Scopes und was sie tun.

Dein Client sieht nur Tools, für die der Token **alle** genannten Scopes hat.
Änderungen wirken direkt auf dein Konto; lass dir Schreib- und Löschaktionen
vom Assistenten zeigen, bevor sie laufen.

## Voice Agents

| Tool | Scopes | Was es tut |
| - | - | - |
| `list_voice_agents` | `voice_agents:read` | Deine Agents auflisten |
| `get_voice_agent` | `voice_agents:read` | Einen Agent per ID lesen |
| `deploy_voice_agent` | `voice_agents:write` | Einen Agent anlegen (Name, optional Prompt, Stimm- und Wissensdatenbank-Einstellungen). Verbindet keine Rufnummer |
| `update_voice_agent` | `voice_agents:write` | Name oder Beschreibung ändern |
| `delete_voice_agent` | `voice_agents:write` | Einen Agent löschen |

## Einstellungen

Einstellungen sind in `prompts`, `voice_config` und `knowledge_base` gruppiert.

| Tool | Scopes | Was es tut |
| - | - | - |
| `get_voice_agent_concern_schema` | `voice_agents:read` | Schema einer Gruppe lesen: Schlüssel, Typen, erlaubte Werte |
| `get_voice_agent_concern` | `voice_agents:read` | Aktuelle Werte einer Gruppe lesen |
| `update_voice_agent_concern` | `voice_agents:read`, `voice_agents:write` | **Eine** Einstellung ändern; die Antwort listet Nebenwirkungen |
| `set_agent_prompt` | `voice_agents:read`, `voice_agents:write` | Eine Einstellung in der Gruppe `prompts` ändern |

## Tools

| Tool | Scopes | Was es tut |
| - | - | - |
| `list_tool_types` | `tools:read` | Erstellbare Typen mit Hinweisen |
| `list_tools` | `tools:read` | Deine Tools; mit Agent-ID, ob jedes dafür aktiv ist |
| `get_tool` | `tools:read` | Ein Tool lesen |
| `create_tool` | `tools:write` | Ein Tool erstellen |
| `update_tool` | `tools:write` | Definition eines Tools ändern |
| `enable_tool` / `disable_tool` | `tools:write` | Ein Tool für einen Agent ein- oder ausschalten |
| `delete_tool` | `tools:write` | Ein Tool löschen; nur `external:api`-Tools |
| `execute_tool` | `tools:execute` | Ein Tool echt ausführen, zum Test |

## Gespräche

| Tool | Scopes | Was es tut |
| - | - | - |
| `list_conversations` | `conversations:read` | Vergangene Gespräche, gefiltert nach Datum, Nummer, Kanal oder Anrufergebnis, seitenweise |
| `get_conversation` | `conversations:read` | Ein Gespräch mit Transkript, soweit die Aufbewahrung es behält |

`list_conversations` akzeptiert `page`, `perPage` (1-50), `fromDate`, `toDate`,
`number` (Agent-ID oder Telefonnummer), `callerNumber`, `searchText`, `channel`
(ein Wert oder ein Array) und `result`. `searchText` durchsucht keine Transkripte.
Die Antwort liefert eine Seite mit `has_more`; halte Datumsgrenzen fest und
entferne doppelte Einträge anhand von `id` über mehrere Seiten hinweg. Für
Datumsangaben ohne Offset gilt Europe/Berlin.

`get_conversation` erwartet `conversationId`, entweder eine numerische ID oder
die öffentliche `conversation_id` aus der Liste. Transkripte fehlen, wenn die
Aufbewahrung den Zugriff nicht erlaubt; versteckte/technische Nachrichten und
Audioaufnahmen werden nicht ausgegeben. Beide Tools teilen sich das
API-Kontingent des Kontos, vermeide daher dauerhaftes Polling.

Evaluations-Tools (`evals:*`, `eval_runs:*`) gibt es ebenfalls; diese Anleitung
behandelt sie noch nicht.

## Prompts

| Prompt | Inhalt |
| - | - |
| `prompting-guide` | Der deutsche [Prompting Guide](https://aipro.placetel.de/docs/de/ai-prompts.md) |
| `schema-guide` | Die englische **API Reference → Set up a voice agent** |

Beide teilen dem Assistenten außerdem mit, welche MCP-Tools dein Token erlaubt.
Wie du sie aufrufst, steht unter [Anleitungen als MCP-Prompts](https://aipro.placetel.de/docs/de/mcp/guides.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.