Agents

Verwende einen API-Schlüssel oder REST-OAuth-Access-Token. Scopes und deine aktuellen Workspace-Rechte gelten gemeinsam. Die Beispiele verwenden fiktive Daten.

Agent erstellen

POST /api/external/v1/agents

Scope: agents:write

Speichert die Konfiguration direkt; führt keinen Anruf, Tooltest oder Nachrichtenversand aus.

Request-Body · application/json

FelderBeispiel

Feld	Typ	Pflicht	Beschreibung
agent	object	Ja	Einstellungen für Gespräch, Spracherkennung und Stimme.
options	object	Ja	Einstellungen für Modell, Prompt und Wissenssuche.

agent — Felder

Feld	Typ	Pflicht	Beschreibung
enabled	boolean	Nein	Aktiviert den Agent. Auslassen oder null bedeutet false.
agentType	string	Ja	VOICE führt Telefongespräche; AGENTIC ist ein Fachagent in einem Agentic Flow. Werte: AGENTIC, VOICE
title	string	Ja	Anzeigename der Ressource. Regeln: höchstens 255 Zeichen Beispiel: "Demo"
description	string	Nein	Beschreibung des Zwecks dieser Ressource. Regeln: höchstens 10000 Zeichen; null erlaubt
agentName	string	Ja	Name, mit dem sich der Agent im Gespräch vorstellt. Regeln: höchstens 255 Zeichen Beispiel: "Demo Assistant"
persona	string	Nein	Persönlichkeit und Sprechstil des Agents. Regeln: höchstens 10000 Zeichen; null erlaubt
sttLanguages	Liste von string	Ja	Sprachen, die Azure erkennen soll. Bei einem anderen Spracherkennungsanbieter bleiben die Werte gespeichert. Regeln: mindestens 1 Eintrag; keine doppelten Einträge Beispiel: ["de-DE"] Alle 85 erlaubten Werte anzeigen de-DE, de-AT, de-CH, en-US, en-GB, en-AU, en-CA, en-IE, en-IN, es-ES, es-MX, fr-FR, fr-CA, nl-NL, nl-BE, pt-BR, pt-PT, ja-JP, zh-CN, zh-HK, it-IT, pl-PL, cs-CZ, da-DK, sv-SE, fi-FI, el-GR, ru-RU, tr-TR, ar-EG, af-ZA, am-ET, hy-AM, az-AZ, bn-IN, bs-BA, bg-BG, ca-ES, hr-HR, et-EE, fa-IR, fil-PH, ka-GE, gl-ES, gu-IN, he-IL, hi-IN, hu-HU, is-IS, id-ID, jv-ID, kn-IN, kk-KZ, km-KH, ko-KR, lo-LA, lt-LT, lv-LV, mk-MK, ms-MY, mt-MT, mn-MN, nb-NO, ne-NP, pa-IN, ps-AF, sw-KE, ta-IN, te-IN, th-TH, uk-UA, ur-PK, uz-UZ, vi-VN, sr-RS, sq-AL, so-SO, sl-SI, sk-SK, si-LK, ro-RO, my-MM, ml-IN, ga-IE, cy-GB
voiceId	string	Ja	Exakte ID aus dem Stimmenkatalog einschließlich Anbieterpräfix. Regeln: höchstens 255 Zeichen
voiceConfiguration	object	Nein	Von der gewählten Stimme unterstützte Parameter. null entfernt sie beim Agent-Update.
greetingMorningText	string	Ja	Begrüßung am Morgen gemäß der Zeitzone des Agents. Regeln: höchstens 4000 Zeichen
greetingAfternoonText	string	Ja	Begrüßung am Nachmittag gemäß der Zeitzone des Agents. Regeln: höchstens 4000 Zeichen
greetingEveningText	string	Ja	Begrüßung am Abend gemäß der Zeitzone des Agents. Regeln: höchstens 4000 Zeichen
importantNote	string	Nein	Zusätzliche Anweisungen für den Agent. Regeln: höchstens 10000 Zeichen; null erlaubt
initialSilenceTimeoutMs	integer (int32)	Ja	Wie lange Azure auf den Beginn einer Äußerung wartet, in Millisekunden. Regeln: 0–60000 Beispiel: 1500
segmentationSilenceTimeoutMs	integer (int32)	Ja	Stille, nach der Azure erkannte Sprache in Abschnitte trennt, in Millisekunden. Regeln: 100–5000 Beispiel: 500
phraseList	Liste von string	Nein	Wörter oder Ausdrücke als Erkennungshilfe, etwa Produktnamen. Als einzelne Listeneinträge senden, nicht als kommagetrennten Text. Regeln: höchstens 500 Einträge; null erlaubt Beispiel: ["Nuvoca"] Je Eintrag: höchstens 500 Zeichen
timezone	string	Nein	IANA-Zeitzone für zeitabhängiges Agent-Verhalten, etwa Europe/Berlin. Regeln: höchstens 100 Zeichen; null erlaubt Beispiel: "Europe/Berlin"
greetingNonInterruptible	boolean	Nein	Verhindert, dass der Anrufer die Begrüßung unterbricht. Regeln: null erlaubt
greetingTimeoutSeconds	integer (int32)	Nein	Zeitlimit für die Begrüßung, in Sekunden. Regeln: 5–300; null erlaubt Beispiel: 30
sttProvider	string	Nein	Spracherkennungsanbieter aus dem Agent-Katalog. Regeln: null erlaubt Werte: AZURE, DEEPGRAM, KUGEL
deepgramEotThreshold	number	Nein	Konfidenz, ab der Deepgram den Gesprächsbeitrag als beendet einstuft. Regeln: 0.5–0.9; null erlaubt
deepgramEotTimeoutMs	integer (int32)	Nein	Deepgram-Zeitlimit für das Erkennen des Beitragsendes, in Millisekunden. Regeln: 500–10000; null erlaubt
deepgramLanguageHints	Liste von string	Nein	Sprachhinweise aus dem Agent-Katalog. Sie gewichten die Deepgram-Erkennung, ohne die unterstützten Sprachen einzuschränken. Regeln: keine doppelten Einträge; null erlaubt Alle 10 erlaubten Werte anzeigen de, en, es, fr, hi, it, ja, nl, pt, ru
preferPreProcessingGreeting	boolean	Nein	Verwendet die Begrüßung aus dem Pre Processing, sofern sie vorliegt. Regeln: null erlaubt
kugelLanguages	Liste von string	Nein	Geordnete Kugel-Sprachcodes aus dem Agent-Katalog. Die erste Sprache wird zu Gesprächsbeginn erwartet. Beim Anlegen gilt standardmäßig Deutsch; Auslassen beim Update behält die Liste. Regeln: 1–9 Einträge; null erlaubt
kugelTurnDetectionLevel	string	Nein	RESPONSIVE reagiert zügig; CONSERVATIVE wartet bei Denkpausen länger. Gilt für neue Anrufe; Auslassen beim Update behält die Einstellung. Regeln: null erlaubt Werte: RESPONSIVE, CONSERVATIVE

voiceConfiguration — Felder

Feld	Typ	Pflicht	Beschreibung
temperature	number (double)	Nein	Sampling-Temperatur der Stimme. Niedrigere Werte erzeugen gleichmäßigere Sprache. Regeln: 0.3–1; null erlaubt
topP	number (double)	Nein	Top-p-Sampling-Einstellung, sofern von der Stimme unterstützt. Regeln: 0.3–1; null erlaubt
topK	integer (int32)	Nein	Top-k-Sampling-Einstellung, sofern von der Stimme unterstützt. Regeln: 1–50; null erlaubt
cfgScale	number (double)	Nein	Stärke der Stimmsteuerung, sofern die Stimme diesen Parameter unterstützt. Regeln: 1–2; null erlaubt
telecomEffectEnabled	boolean	Nein	Aktiviert Telefonklang für unterstützte Azure-HD-Stimmen. null verwendet den Plattformstandard.
enhancePronunciationEnabled	boolean	Nein	Aktiviert die Ausspracheverfeinerung für unterstützte Azure-HD-Stimmen. null verwendet den Plattformstandard.
xmlLang	string	Nein	Von der gewählten Stimme unterstützter Sprach- oder Akzentcode. Regeln: höchstens 10 Zeichen; null erlaubt Beispiel: "de-AT"
style	string	Nein	Von der gewählten Stimme unterstützter Sprechstil. Regeln: höchstens 50 Zeichen; null erlaubt

options — Felder

Feld	Typ	Pflicht	Beschreibung
model	string	Ja	Agent-Modell aus dem Agent-Katalog. Reasoning-, Temperatur- und Outputgrenzen des Eintrags beachten. Alle 19 erlaubten Werte anzeigen GPT_6_1_SOL, GPT_6_1_TERRA, GPT_6_SOL, GPT_6_LUNA, GPT_5_6_SOL, GPT_5_6_TERRA, GPT_5_6_LUNA, GPT_5, GPT_5_MINI, GPT_5_NANO, GPT_5_4, GPT_5_4_MINI, GPT_5_4_NANO, GPT_4_1, GPT_4_1_MINI, GPT_4_1_NANO, DEEPSEEK_V4_FLASH, MISTRAL_LARGE_3, MICROSOFT_DECISION_1
reasoningEffort	string	Nein	Vom gewählten Modell unterstützter Reasoning-Aufwand gemäß Agent-Katalog. Werte: NONE, MINIMAL, LOW
systemPrompt	string	Ja	Vollständige Agent-Anweisungen einschließlich Verhalten, Wissensgrenzen und Fehlerbehandlung. Regeln: höchstens 100000 Zeichen
conversationHistoryLimit	integer (int32)	Ja	Maximale Anzahl der Gesprächsverlaufseinträge für das Modell. Regeln: 1–100 Beispiel: 20
knowledgeBaseId	string (uuid)	Nein	ID der zugeordneten Knowledge Base. null entfernt die Zuordnung.
ragTopK	integer (int32)	Ja	Maximale Anzahl abgerufener Wissensabschnitte pro Suche. Regeln: 1–50 Beispiel: 5
ragSimilarityThreshold	number (double)	Nein	Mindestähnlichkeit eines Wissensabschnitts, damit er berücksichtigt wird. Regeln: 0–1 Beispiel: 0.5
temperature	number (double)	Nein	Variation der Antworten. Eine feste Temperatur im Katalogeintrag des Modells beachten. Regeln: 0–2 Beispiel: 0.3
maxTokens	integer (int32)	Ja	Maximales Output-Tokenbudget. Zusätzlich die Grenze des gewählten Modells im Katalog beachten. Regeln: 10–25000 Beispiel: 1000
ttsStreamingMode	string	Nein	Sprachausgabemodus aus dem Agent-Katalog. Werte: QUALITY_SSML, LOW_LATENCY_TEXT_STREAM
queryTransformEnabled	boolean	Nein	Formuliert Wissenssuchanfragen vor der Suche um. Auslassen oder null bedeutet false.
queryTransformHistoryLimit	integer (int32)	Ja	Maximale Anzahl der Gesprächsverlaufseinträge für die Suchumformulierung. Regeln: 1–100 Beispiel: 5
queryTransformPrompt	string	Nein	Prompt zur Suchumformulierung im LLM-Modus. DECISION verwendet decisionQueryTransform. Regeln: höchstens 20000 Zeichen
queryTransformConfidenceThreshold	number (double)	Nein	Erforderliche Konfidenz für die Suchumformulierung. Regeln: 0–1 Beispiel: 0.8
queryTransformMode	string	Nein	Verwendet eine LLM-Umformulierung oder einen separaten Suchentscheid mit Umformulierung. Werte: LLM, DECISION
decisionQueryTransform	object	Nein	Einstellungen für Suchentscheidung und Suchumformulierung. Die Funktion muss im Agent-Katalog verfügbar sein.

decisionQueryTransform — Felder

Feld	Typ	Pflicht	Beschreibung
rewriteModel	string	Nein	Modell zur Suchumformulierung. Im Katalog ein Modell mit supportsQueryRewrite=true wählen. Alle 19 erlaubten Werte anzeigen GPT_6_1_SOL, GPT_6_1_TERRA, GPT_6_SOL, GPT_6_LUNA, GPT_5_6_SOL, GPT_5_6_TERRA, GPT_5_6_LUNA, GPT_5, GPT_5_MINI, GPT_5_NANO, GPT_5_4, GPT_5_4_MINI, GPT_5_4_NANO, GPT_4_1, GPT_4_1_MINI, GPT_4_1_NANO, DEEPSEEK_V4_FLASH, MISTRAL_LARGE_3, MICROSOFT_DECISION_1
parallel	boolean	Nein	Führt Suchentscheidung und Suchumformulierung gleichzeitig aus.
decisionPrompt	string	Nein	Regeln für die Entscheidung, ob in der Knowledge Base gesucht wird: SEARCH oder SKIP.
rewritePrompt	string	Nein	Anweisungen zur Umformulierung der Wissenssuchanfrage.

{
  "agent": {
    "enabled": false,
    "agentType": "VOICE",
    "title": "NuvoCar Empfang – Entwurf",
    "agentName": "NuvoCar Assistent",
    "sttProvider": "AZURE",
    "sttLanguages": [
      "de-DE"
    ],
    "voiceId": "azure:FLORIAN_HD",
    "timezone": "Europe/Berlin",
    "greetingMorningText": "Guten Morgen, hier ist der digitale Assistent von NuvoCar. Wie kann ich helfen?",
    "greetingAfternoonText": "Guten Tag, hier ist der digitale Assistent von NuvoCar. Wie kann ich helfen?",
    "greetingEveningText": "Guten Abend, hier ist der digitale Assistent von NuvoCar. Wie kann ich helfen?",
    "initialSilenceTimeoutMs": 1500,
    "segmentationSilenceTimeoutMs": 500,
    "phraseList": [
      "NuvoCar"
    ]
  },
  "options": {
    "model": "GPT_4_1_MINI",
    "systemPrompt": "Du bist der digitale Empfang von NuvoCar. Frage nach dem Anliegen. Erfinde keine Preise oder Termine. Erkläre offen, wenn eine Auskunft fehlt. Behaupte keine Speicherung oder Weiterleitung ohne erfolgreiche konfigurierte Aktion.",
    "conversationHistoryLimit": 20,
    "knowledgeBaseId": null,
    "ragTopK": 5,
    "ragSimilarityThreshold": 0.5,
    "temperature": 0.3,
    "maxTokens": 1000,
    "ttsStreamingMode": "QUALITY_SSML",
    "queryTransformEnabled": false,
    "queryTransformHistoryLimit": 5,
    "queryTransformConfidenceThreshold": 0.8,
    "queryTransformMode": "LLM"
  }
}

Antwort 201

Erstellt.

Header	Typ	Beschreibung
Cache-Control	string	Die Antwort darf nicht zwischengespeichert werden. Beispiel: no-store
Location	string	Pfad der erstellten Ressource.
ETag	string	Aktuelle Revision. Bei erforderlichem If-Match unverändert einschließlich Anführungszeichen senden. Beispiel: "revision-from-get"

application/json

FelderBeispiel

Feld	Typ	Beschreibung
id	string (uuid)	Ressourcen-ID in deinem Workspace.
revision	string	Aktuelle Ressourcenrevision. Beim Ändern den ETag der Antwort als If-Match senden.
agent	object	Einstellungen für Gespräch, Spracherkennung und Stimme.
options	object	Einstellungen für Modell, Prompt und Wissenssuche.

agent — Felder

Feld	Typ	Beschreibung
enabled	boolean	Aktiviert den Agent. Auslassen oder null bedeutet false.
agentType	string	VOICE führt Telefongespräche; AGENTIC ist ein Fachagent in einem Agentic Flow. Werte: AGENTIC, VOICE
title	string	Anzeigename der Ressource. Regeln: höchstens 255 Zeichen Beispiel: "Demo"
description	string	Beschreibung des Zwecks dieser Ressource. Regeln: höchstens 10000 Zeichen; null erlaubt
agentName	string	Name, mit dem sich der Agent im Gespräch vorstellt. Regeln: höchstens 255 Zeichen Beispiel: "Demo Assistant"
persona	string	Persönlichkeit und Sprechstil des Agents. Regeln: höchstens 10000 Zeichen; null erlaubt
sttLanguages	Liste von string	Sprachen, die Azure erkennen soll. Bei einem anderen Spracherkennungsanbieter bleiben die Werte gespeichert. Regeln: mindestens 1 Eintrag; keine doppelten Einträge Beispiel: ["de-DE"] Alle 85 erlaubten Werte anzeigen de-DE, de-AT, de-CH, en-US, en-GB, en-AU, en-CA, en-IE, en-IN, es-ES, es-MX, fr-FR, fr-CA, nl-NL, nl-BE, pt-BR, pt-PT, ja-JP, zh-CN, zh-HK, it-IT, pl-PL, cs-CZ, da-DK, sv-SE, fi-FI, el-GR, ru-RU, tr-TR, ar-EG, af-ZA, am-ET, hy-AM, az-AZ, bn-IN, bs-BA, bg-BG, ca-ES, hr-HR, et-EE, fa-IR, fil-PH, ka-GE, gl-ES, gu-IN, he-IL, hi-IN, hu-HU, is-IS, id-ID, jv-ID, kn-IN, kk-KZ, km-KH, ko-KR, lo-LA, lt-LT, lv-LV, mk-MK, ms-MY, mt-MT, mn-MN, nb-NO, ne-NP, pa-IN, ps-AF, sw-KE, ta-IN, te-IN, th-TH, uk-UA, ur-PK, uz-UZ, vi-VN, sr-RS, sq-AL, so-SO, sl-SI, sk-SK, si-LK, ro-RO, my-MM, ml-IN, ga-IE, cy-GB
voiceId	string	Exakte ID aus dem Stimmenkatalog einschließlich Anbieterpräfix. Regeln: höchstens 255 Zeichen
voiceConfiguration	object	Von der gewählten Stimme unterstützte Parameter. null entfernt sie beim Agent-Update.
greetingMorningText	string	Begrüßung am Morgen gemäß der Zeitzone des Agents. Regeln: höchstens 4000 Zeichen
greetingAfternoonText	string	Begrüßung am Nachmittag gemäß der Zeitzone des Agents. Regeln: höchstens 4000 Zeichen
greetingEveningText	string	Begrüßung am Abend gemäß der Zeitzone des Agents. Regeln: höchstens 4000 Zeichen
importantNote	string	Zusätzliche Anweisungen für den Agent. Regeln: höchstens 10000 Zeichen; null erlaubt
initialSilenceTimeoutMs	integer (int32)	Wie lange Azure auf den Beginn einer Äußerung wartet, in Millisekunden. Regeln: 0–60000 Beispiel: 1500
segmentationSilenceTimeoutMs	integer (int32)	Stille, nach der Azure erkannte Sprache in Abschnitte trennt, in Millisekunden. Regeln: 100–5000 Beispiel: 500
phraseList	Liste von string	Wörter oder Ausdrücke als Erkennungshilfe, etwa Produktnamen. Als einzelne Listeneinträge senden, nicht als kommagetrennten Text. Regeln: höchstens 500 Einträge; null erlaubt Beispiel: ["Nuvoca"] Je Eintrag: höchstens 500 Zeichen
timezone	string	IANA-Zeitzone für zeitabhängiges Agent-Verhalten, etwa Europe/Berlin. Regeln: höchstens 100 Zeichen; null erlaubt Beispiel: "Europe/Berlin"
greetingNonInterruptible	boolean	Verhindert, dass der Anrufer die Begrüßung unterbricht. Regeln: null erlaubt
greetingTimeoutSeconds	integer (int32)	Zeitlimit für die Begrüßung, in Sekunden. Regeln: 5–300; null erlaubt Beispiel: 30
sttProvider	string	Spracherkennungsanbieter aus dem Agent-Katalog. Regeln: null erlaubt Werte: AZURE, DEEPGRAM, KUGEL
deepgramEotThreshold	number	Konfidenz, ab der Deepgram den Gesprächsbeitrag als beendet einstuft. Regeln: 0.5–0.9; null erlaubt
deepgramEotTimeoutMs	integer (int32)	Deepgram-Zeitlimit für das Erkennen des Beitragsendes, in Millisekunden. Regeln: 500–10000; null erlaubt
deepgramLanguageHints	Liste von string	Sprachhinweise aus dem Agent-Katalog. Sie gewichten die Deepgram-Erkennung, ohne die unterstützten Sprachen einzuschränken. Regeln: keine doppelten Einträge; null erlaubt Alle 10 erlaubten Werte anzeigen de, en, es, fr, hi, it, ja, nl, pt, ru
preferPreProcessingGreeting	boolean	Verwendet die Begrüßung aus dem Pre Processing, sofern sie vorliegt. Regeln: null erlaubt
kugelLanguages	Liste von string	Geordnete Kugel-Sprachcodes aus dem Agent-Katalog. Die erste Sprache wird zu Gesprächsbeginn erwartet. Beim Anlegen gilt standardmäßig Deutsch; Auslassen beim Update behält die Liste. Regeln: 1–9 Einträge; null erlaubt
kugelTurnDetectionLevel	string	RESPONSIVE reagiert zügig; CONSERVATIVE wartet bei Denkpausen länger. Gilt für neue Anrufe; Auslassen beim Update behält die Einstellung. Regeln: null erlaubt Werte: RESPONSIVE, CONSERVATIVE

voiceConfiguration — Felder

Feld	Typ	Beschreibung
temperature	number (double)	Sampling-Temperatur der Stimme. Niedrigere Werte erzeugen gleichmäßigere Sprache. Regeln: 0.3–1; null erlaubt
topP	number (double)	Top-p-Sampling-Einstellung, sofern von der Stimme unterstützt. Regeln: 0.3–1; null erlaubt
topK	integer (int32)	Top-k-Sampling-Einstellung, sofern von der Stimme unterstützt. Regeln: 1–50; null erlaubt
cfgScale	number (double)	Stärke der Stimmsteuerung, sofern die Stimme diesen Parameter unterstützt. Regeln: 1–2; null erlaubt
telecomEffectEnabled	boolean	Aktiviert Telefonklang für unterstützte Azure-HD-Stimmen. null verwendet den Plattformstandard.
enhancePronunciationEnabled	boolean	Aktiviert die Ausspracheverfeinerung für unterstützte Azure-HD-Stimmen. null verwendet den Plattformstandard.
xmlLang	string	Von der gewählten Stimme unterstützter Sprach- oder Akzentcode. Regeln: höchstens 10 Zeichen; null erlaubt Beispiel: "de-AT"
style	string	Von der gewählten Stimme unterstützter Sprechstil. Regeln: höchstens 50 Zeichen; null erlaubt

options — Felder

Feld	Typ	Beschreibung
model	string	Agent-Modell aus dem Agent-Katalog. Reasoning-, Temperatur- und Outputgrenzen des Eintrags beachten. Alle 19 erlaubten Werte anzeigen GPT_6_1_SOL, GPT_6_1_TERRA, GPT_6_SOL, GPT_6_LUNA, GPT_5_6_SOL, GPT_5_6_TERRA, GPT_5_6_LUNA, GPT_5, GPT_5_MINI, GPT_5_NANO, GPT_5_4, GPT_5_4_MINI, GPT_5_4_NANO, GPT_4_1, GPT_4_1_MINI, GPT_4_1_NANO, DEEPSEEK_V4_FLASH, MISTRAL_LARGE_3, MICROSOFT_DECISION_1
reasoningEffort	string	Vom gewählten Modell unterstützter Reasoning-Aufwand gemäß Agent-Katalog. Werte: NONE, MINIMAL, LOW
systemPrompt	string	Vollständige Agent-Anweisungen einschließlich Verhalten, Wissensgrenzen und Fehlerbehandlung. Regeln: höchstens 100000 Zeichen
conversationHistoryLimit	integer (int32)	Maximale Anzahl der Gesprächsverlaufseinträge für das Modell. Regeln: 1–100 Beispiel: 20
knowledgeBaseId	string (uuid)	ID der zugeordneten Knowledge Base. null entfernt die Zuordnung.
ragTopK	integer (int32)	Maximale Anzahl abgerufener Wissensabschnitte pro Suche. Regeln: 1–50 Beispiel: 5
ragSimilarityThreshold	number (double)	Mindestähnlichkeit eines Wissensabschnitts, damit er berücksichtigt wird. Regeln: 0–1 Beispiel: 0.5
temperature	number (double)	Variation der Antworten. Eine feste Temperatur im Katalogeintrag des Modells beachten. Regeln: 0–2 Beispiel: 0.3
maxTokens	integer (int32)	Maximales Output-Tokenbudget. Zusätzlich die Grenze des gewählten Modells im Katalog beachten. Regeln: 10–25000 Beispiel: 1000
ttsStreamingMode	string	Sprachausgabemodus aus dem Agent-Katalog. Werte: QUALITY_SSML, LOW_LATENCY_TEXT_STREAM
queryTransformEnabled	boolean	Formuliert Wissenssuchanfragen vor der Suche um. Auslassen oder null bedeutet false.
queryTransformHistoryLimit	integer (int32)	Maximale Anzahl der Gesprächsverlaufseinträge für die Suchumformulierung. Regeln: 1–100 Beispiel: 5
queryTransformPrompt	string	Prompt zur Suchumformulierung im LLM-Modus. DECISION verwendet decisionQueryTransform. Regeln: höchstens 20000 Zeichen
queryTransformConfidenceThreshold	number (double)	Erforderliche Konfidenz für die Suchumformulierung. Regeln: 0–1 Beispiel: 0.8
queryTransformMode	string	Verwendet eine LLM-Umformulierung oder einen separaten Suchentscheid mit Umformulierung. Werte: LLM, DECISION
decisionQueryTransform	object	Einstellungen für Suchentscheidung und Suchumformulierung. Die Funktion muss im Agent-Katalog verfügbar sein.

decisionQueryTransform — Felder

Feld	Typ	Beschreibung
rewriteModel	string	Modell zur Suchumformulierung. Im Katalog ein Modell mit supportsQueryRewrite=true wählen. Alle 19 erlaubten Werte anzeigen GPT_6_1_SOL, GPT_6_1_TERRA, GPT_6_SOL, GPT_6_LUNA, GPT_5_6_SOL, GPT_5_6_TERRA, GPT_5_6_LUNA, GPT_5, GPT_5_MINI, GPT_5_NANO, GPT_5_4, GPT_5_4_MINI, GPT_5_4_NANO, GPT_4_1, GPT_4_1_MINI, GPT_4_1_NANO, DEEPSEEK_V4_FLASH, MISTRAL_LARGE_3, MICROSOFT_DECISION_1
parallel	boolean	Führt Suchentscheidung und Suchumformulierung gleichzeitig aus.
decisionPrompt	string	Regeln für die Entscheidung, ob in der Knowledge Base gesucht wird: SEARCH oder SKIP.
rewritePrompt	string	Anweisungen zur Umformulierung der Wissenssuchanfrage.

{
  "id": "00000000-0000-0000-0000-000000000001",
  "revision": "revision-from-get",
  "agent": {
    "enabled": false,
    "agentType": "VOICE",
    "title": "Demo",
    "description": "string",
    "agentName": "Demo Assistant",
    "persona": "string",
    "sttLanguages": [
      "de-DE"
    ],
    "voiceId": "azure:FLORIAN_HD",
    "voiceConfiguration": {
      "temperature": 0.3,
      "topP": 0.3,
      "topK": 1,
      "cfgScale": 1,
      "telecomEffectEnabled": false,
      "enhancePronunciationEnabled": false,
      "xmlLang": "de-AT",
      "style": "string"
    },
    "greetingMorningText": "string",
    "greetingAfternoonText": "string",
    "greetingEveningText": "string",
    "importantNote": "string",
    "initialSilenceTimeoutMs": 1500,
    "segmentationSilenceTimeoutMs": 500,
    "phraseList": [
      "Nuvoca"
    ],
    "timezone": "Europe/Berlin",
    "greetingNonInterruptible": false,
    "greetingTimeoutSeconds": 30,
    "sttProvider": "AZURE",
    "deepgramEotThreshold": 0.5,
    "deepgramEotTimeoutMs": 500,
    "deepgramLanguageHints": [],
    "preferPreProcessingGreeting": false,
    "kugelLanguages": [
      "string"
    ],
    "kugelTurnDetectionLevel": "RESPONSIVE"
  },
  "options": {
    "model": "GPT_4_1_MINI",
    "reasoningEffort": "NONE",
    "systemPrompt": "string",
    "conversationHistoryLimit": 20,
    "knowledgeBaseId": "00000000-0000-0000-0000-000000000001",
    "ragTopK": 5,
    "ragSimilarityThreshold": 0.5,
    "temperature": 0.3,
    "maxTokens": 1000,
    "ttsStreamingMode": "QUALITY_SSML",
    "queryTransformEnabled": false,
    "queryTransformHistoryLimit": 5,
    "queryTransformPrompt": "string",
    "queryTransformConfidenceThreshold": 0.8,
    "queryTransformMode": "LLM",
    "decisionQueryTransform": {
      "rewriteModel": "GPT_4_1_MINI",
      "parallel": false,
      "decisionPrompt": "string",
      "rewritePrompt": "string"
    }
  }
}

Fehlerantworten

Status	Bedeutung
400	Ungültige Eingabe, Auswahl oder Zeitgrenzen.
401	Fehlender, abgelaufener oder ungültiger Zugang. Der Body kann leer sein.
403	Benötigter Scope oder aktuelles Benutzerrecht fehlt. Der Body kann leer sein.
409	Fehlende/veraltete Revision oder Abhängigkeits-/Routingkonflikt. Vor erneutem Versuch neu lesen.
429	Gemeinsames Workspace-Budget überschritten. Retry-After abwarten; unklare Schreibvorgänge nicht blind wiederholen.
503	Vorübergehend nicht verfügbar. Unklare Schreibvorgänge vor erneutem Versuch prüfen.

Fehler-Body

Feld	Typ	Beschreibung
status	integer	HTTP-Statuscode.
error	string	Beschreibung des Fehlers.
details	any	Weitere Fehlerdetails, sofern vorhanden. Regeln: null erlaubt
code	string	Maschinenlesbarer Fehlercode.
params	object	Zusätzliche Werte zum Fehlercode.
fieldErrors	object	Validierungsfehler nach Eingabefeld.

Bei 429 oder 503 den Header Retry-After (Sekunden) beachten. Unklare Schreibvorgänge vor einem neuen Versuch prüfen.

Agents auflisten

GET /api/external/v1/agents

Scope: agents:read

Parameter

Name	Position	Typ	Pflicht	Beschreibung
page	Query	integer (int32)	Nein	Seitenindex ab 0. Regeln: 0–100000 Standard: 0
size	Query	integer (int32)	Nein	Ergebnisse pro Seite. Regeln: 1–100 Standard: 25

Antwort 200

Erfolgreich.

Header	Typ	Beschreibung
Cache-Control	string	Die Antwort darf nicht zwischengespeichert werden. Beispiel: no-store

application/json

FelderBeispiel

Feld	Typ	Beschreibung
items	Liste von object	Ergebnisse dieser Seite.
page	integer (int32)	Aktueller Seitenindex, beginnend bei 0.
size	integer (int32)	Angeforderte Anzahl der Ergebnisse pro Seite.
totalElements	integer (int64)	Gesamtzahl der passenden Ergebnisse.
totalPages	integer (int32)	Gesamtzahl der Ergebnisseiten.

items — Felder

Feld	Typ	Beschreibung
agentId	string (uuid)	ID des Agents.
tenantId	string (uuid)	ID des mit dem Zugang verbundenen Workspaces.
enabled	boolean	Ob diese Ressource aktiviert ist.
agentType	string	VOICE führt Telefongespräche; AGENTIC ist ein Fachagent in einem Agentic Flow. Werte: AGENTIC, VOICE
title	string	Anzeigename der Ressource.
description	string	Beschreibung des Zwecks dieser Ressource.
agentName	string	Name, mit dem sich der Agent im Gespräch vorstellt.

{
  "items": [
    {
      "agentId": "00000000-0000-0000-0000-000000000001",
      "tenantId": "00000000-0000-0000-0000-000000000001",
      "enabled": false,
      "agentType": "VOICE",
      "title": "NuvoCar service",
      "description": "string",
      "agentName": "string"
    }
  ],
  "page": 0,
  "size": 25,
  "totalElements": 1,
  "totalPages": 1
}

Fehlerantworten

Status	Bedeutung
400	Ungültige Eingabe, Auswahl oder Zeitgrenzen.
401	Fehlender, abgelaufener oder ungültiger Zugang. Der Body kann leer sein.
403	Benötigter Scope oder aktuelles Benutzerrecht fehlt. Der Body kann leer sein.
429	Gemeinsames Workspace-Budget überschritten. Retry-After abwarten; unklare Schreibvorgänge nicht blind wiederholen.
503	Vorübergehend nicht verfügbar. Unklare Schreibvorgänge vor erneutem Versuch prüfen.

Fehler-Body

Feld	Typ	Beschreibung
status	integer	HTTP-Statuscode.
error	string	Beschreibung des Fehlers.
details	any	Weitere Fehlerdetails, sofern vorhanden. Regeln: null erlaubt
code	string	Maschinenlesbarer Fehlercode.
params	object	Zusätzliche Werte zum Fehlercode.
fieldErrors	object	Validierungsfehler nach Eingabefeld.

Bei 429 oder 503 den Header Retry-After (Sekunden) beachten. Unklare Schreibvorgänge vor einem neuen Versuch prüfen.

Agent abrufen

GET /api/external/v1/agents/{id}

Scope: agents:configuration:read

Parameter

Name	Position	Typ	Pflicht	Beschreibung
id	Pfad	string (uuid)	Ja	Ressourcen-ID im gebundenen Workspace.

Antwort 200

Erfolgreich.

Header	Typ	Beschreibung
Cache-Control	string	Die Antwort darf nicht zwischengespeichert werden. Beispiel: no-store
ETag	string	Aktuelle Revision. Bei erforderlichem If-Match unverändert einschließlich Anführungszeichen senden. Beispiel: "revision-from-get"

application/json

FelderBeispiel

Feld	Typ	Beschreibung
id	string (uuid)	Ressourcen-ID in deinem Workspace.
revision	string	Aktuelle Ressourcenrevision. Beim Ändern den ETag der Antwort als If-Match senden.
agent	object	Einstellungen für Gespräch, Spracherkennung und Stimme.
options	object	Einstellungen für Modell, Prompt und Wissenssuche.

agent — Felder

Feld	Typ	Beschreibung
enabled	boolean	Aktiviert den Agent. Auslassen oder null bedeutet false.
agentType	string	VOICE führt Telefongespräche; AGENTIC ist ein Fachagent in einem Agentic Flow. Werte: AGENTIC, VOICE
title	string	Anzeigename der Ressource. Regeln: höchstens 255 Zeichen Beispiel: "Demo"
description	string	Beschreibung des Zwecks dieser Ressource. Regeln: höchstens 10000 Zeichen; null erlaubt
agentName	string	Name, mit dem sich der Agent im Gespräch vorstellt. Regeln: höchstens 255 Zeichen Beispiel: "Demo Assistant"
persona	string	Persönlichkeit und Sprechstil des Agents. Regeln: höchstens 10000 Zeichen; null erlaubt
sttLanguages	Liste von string	Sprachen, die Azure erkennen soll. Bei einem anderen Spracherkennungsanbieter bleiben die Werte gespeichert. Regeln: mindestens 1 Eintrag; keine doppelten Einträge Beispiel: ["de-DE"] Alle 85 erlaubten Werte anzeigen de-DE, de-AT, de-CH, en-US, en-GB, en-AU, en-CA, en-IE, en-IN, es-ES, es-MX, fr-FR, fr-CA, nl-NL, nl-BE, pt-BR, pt-PT, ja-JP, zh-CN, zh-HK, it-IT, pl-PL, cs-CZ, da-DK, sv-SE, fi-FI, el-GR, ru-RU, tr-TR, ar-EG, af-ZA, am-ET, hy-AM, az-AZ, bn-IN, bs-BA, bg-BG, ca-ES, hr-HR, et-EE, fa-IR, fil-PH, ka-GE, gl-ES, gu-IN, he-IL, hi-IN, hu-HU, is-IS, id-ID, jv-ID, kn-IN, kk-KZ, km-KH, ko-KR, lo-LA, lt-LT, lv-LV, mk-MK, ms-MY, mt-MT, mn-MN, nb-NO, ne-NP, pa-IN, ps-AF, sw-KE, ta-IN, te-IN, th-TH, uk-UA, ur-PK, uz-UZ, vi-VN, sr-RS, sq-AL, so-SO, sl-SI, sk-SK, si-LK, ro-RO, my-MM, ml-IN, ga-IE, cy-GB
voiceId	string	Exakte ID aus dem Stimmenkatalog einschließlich Anbieterpräfix. Regeln: höchstens 255 Zeichen
voiceConfiguration	object	Von der gewählten Stimme unterstützte Parameter. null entfernt sie beim Agent-Update.
greetingMorningText	string	Begrüßung am Morgen gemäß der Zeitzone des Agents. Regeln: höchstens 4000 Zeichen
greetingAfternoonText	string	Begrüßung am Nachmittag gemäß der Zeitzone des Agents. Regeln: höchstens 4000 Zeichen
greetingEveningText	string	Begrüßung am Abend gemäß der Zeitzone des Agents. Regeln: höchstens 4000 Zeichen
importantNote	string	Zusätzliche Anweisungen für den Agent. Regeln: höchstens 10000 Zeichen; null erlaubt
initialSilenceTimeoutMs	integer (int32)	Wie lange Azure auf den Beginn einer Äußerung wartet, in Millisekunden. Regeln: 0–60000 Beispiel: 1500
segmentationSilenceTimeoutMs	integer (int32)	Stille, nach der Azure erkannte Sprache in Abschnitte trennt, in Millisekunden. Regeln: 100–5000 Beispiel: 500
phraseList	Liste von string	Wörter oder Ausdrücke als Erkennungshilfe, etwa Produktnamen. Als einzelne Listeneinträge senden, nicht als kommagetrennten Text. Regeln: höchstens 500 Einträge; null erlaubt Beispiel: ["Nuvoca"] Je Eintrag: höchstens 500 Zeichen
timezone	string	IANA-Zeitzone für zeitabhängiges Agent-Verhalten, etwa Europe/Berlin. Regeln: höchstens 100 Zeichen; null erlaubt Beispiel: "Europe/Berlin"
greetingNonInterruptible	boolean	Verhindert, dass der Anrufer die Begrüßung unterbricht. Regeln: null erlaubt
greetingTimeoutSeconds	integer (int32)	Zeitlimit für die Begrüßung, in Sekunden. Regeln: 5–300; null erlaubt Beispiel: 30
sttProvider	string	Spracherkennungsanbieter aus dem Agent-Katalog. Regeln: null erlaubt Werte: AZURE, DEEPGRAM, KUGEL
deepgramEotThreshold	number	Konfidenz, ab der Deepgram den Gesprächsbeitrag als beendet einstuft. Regeln: 0.5–0.9; null erlaubt
deepgramEotTimeoutMs	integer (int32)	Deepgram-Zeitlimit für das Erkennen des Beitragsendes, in Millisekunden. Regeln: 500–10000; null erlaubt
deepgramLanguageHints	Liste von string	Sprachhinweise aus dem Agent-Katalog. Sie gewichten die Deepgram-Erkennung, ohne die unterstützten Sprachen einzuschränken. Regeln: keine doppelten Einträge; null erlaubt Alle 10 erlaubten Werte anzeigen de, en, es, fr, hi, it, ja, nl, pt, ru
preferPreProcessingGreeting	boolean	Verwendet die Begrüßung aus dem Pre Processing, sofern sie vorliegt. Regeln: null erlaubt
kugelLanguages	Liste von string	Geordnete Kugel-Sprachcodes aus dem Agent-Katalog. Die erste Sprache wird zu Gesprächsbeginn erwartet. Beim Anlegen gilt standardmäßig Deutsch; Auslassen beim Update behält die Liste. Regeln: 1–9 Einträge; null erlaubt
kugelTurnDetectionLevel	string	RESPONSIVE reagiert zügig; CONSERVATIVE wartet bei Denkpausen länger. Gilt für neue Anrufe; Auslassen beim Update behält die Einstellung. Regeln: null erlaubt Werte: RESPONSIVE, CONSERVATIVE

voiceConfiguration — Felder

Feld	Typ	Beschreibung
temperature	number (double)	Sampling-Temperatur der Stimme. Niedrigere Werte erzeugen gleichmäßigere Sprache. Regeln: 0.3–1; null erlaubt
topP	number (double)	Top-p-Sampling-Einstellung, sofern von der Stimme unterstützt. Regeln: 0.3–1; null erlaubt
topK	integer (int32)	Top-k-Sampling-Einstellung, sofern von der Stimme unterstützt. Regeln: 1–50; null erlaubt
cfgScale	number (double)	Stärke der Stimmsteuerung, sofern die Stimme diesen Parameter unterstützt. Regeln: 1–2; null erlaubt
telecomEffectEnabled	boolean	Aktiviert Telefonklang für unterstützte Azure-HD-Stimmen. null verwendet den Plattformstandard.
enhancePronunciationEnabled	boolean	Aktiviert die Ausspracheverfeinerung für unterstützte Azure-HD-Stimmen. null verwendet den Plattformstandard.
xmlLang	string	Von der gewählten Stimme unterstützter Sprach- oder Akzentcode. Regeln: höchstens 10 Zeichen; null erlaubt Beispiel: "de-AT"
style	string	Von der gewählten Stimme unterstützter Sprechstil. Regeln: höchstens 50 Zeichen; null erlaubt

options — Felder

Feld	Typ	Beschreibung
model	string	Agent-Modell aus dem Agent-Katalog. Reasoning-, Temperatur- und Outputgrenzen des Eintrags beachten. Alle 19 erlaubten Werte anzeigen GPT_6_1_SOL, GPT_6_1_TERRA, GPT_6_SOL, GPT_6_LUNA, GPT_5_6_SOL, GPT_5_6_TERRA, GPT_5_6_LUNA, GPT_5, GPT_5_MINI, GPT_5_NANO, GPT_5_4, GPT_5_4_MINI, GPT_5_4_NANO, GPT_4_1, GPT_4_1_MINI, GPT_4_1_NANO, DEEPSEEK_V4_FLASH, MISTRAL_LARGE_3, MICROSOFT_DECISION_1
reasoningEffort	string	Vom gewählten Modell unterstützter Reasoning-Aufwand gemäß Agent-Katalog. Werte: NONE, MINIMAL, LOW
systemPrompt	string	Vollständige Agent-Anweisungen einschließlich Verhalten, Wissensgrenzen und Fehlerbehandlung. Regeln: höchstens 100000 Zeichen
conversationHistoryLimit	integer (int32)	Maximale Anzahl der Gesprächsverlaufseinträge für das Modell. Regeln: 1–100 Beispiel: 20
knowledgeBaseId	string (uuid)	ID der zugeordneten Knowledge Base. null entfernt die Zuordnung.
ragTopK	integer (int32)	Maximale Anzahl abgerufener Wissensabschnitte pro Suche. Regeln: 1–50 Beispiel: 5
ragSimilarityThreshold	number (double)	Mindestähnlichkeit eines Wissensabschnitts, damit er berücksichtigt wird. Regeln: 0–1 Beispiel: 0.5
temperature	number (double)	Variation der Antworten. Eine feste Temperatur im Katalogeintrag des Modells beachten. Regeln: 0–2 Beispiel: 0.3
maxTokens	integer (int32)	Maximales Output-Tokenbudget. Zusätzlich die Grenze des gewählten Modells im Katalog beachten. Regeln: 10–25000 Beispiel: 1000
ttsStreamingMode	string	Sprachausgabemodus aus dem Agent-Katalog. Werte: QUALITY_SSML, LOW_LATENCY_TEXT_STREAM
queryTransformEnabled	boolean	Formuliert Wissenssuchanfragen vor der Suche um. Auslassen oder null bedeutet false.
queryTransformHistoryLimit	integer (int32)	Maximale Anzahl der Gesprächsverlaufseinträge für die Suchumformulierung. Regeln: 1–100 Beispiel: 5
queryTransformPrompt	string	Prompt zur Suchumformulierung im LLM-Modus. DECISION verwendet decisionQueryTransform. Regeln: höchstens 20000 Zeichen
queryTransformConfidenceThreshold	number (double)	Erforderliche Konfidenz für die Suchumformulierung. Regeln: 0–1 Beispiel: 0.8
queryTransformMode	string	Verwendet eine LLM-Umformulierung oder einen separaten Suchentscheid mit Umformulierung. Werte: LLM, DECISION
decisionQueryTransform	object	Einstellungen für Suchentscheidung und Suchumformulierung. Die Funktion muss im Agent-Katalog verfügbar sein.

decisionQueryTransform — Felder

Feld	Typ	Beschreibung
rewriteModel	string	Modell zur Suchumformulierung. Im Katalog ein Modell mit supportsQueryRewrite=true wählen. Alle 19 erlaubten Werte anzeigen GPT_6_1_SOL, GPT_6_1_TERRA, GPT_6_SOL, GPT_6_LUNA, GPT_5_6_SOL, GPT_5_6_TERRA, GPT_5_6_LUNA, GPT_5, GPT_5_MINI, GPT_5_NANO, GPT_5_4, GPT_5_4_MINI, GPT_5_4_NANO, GPT_4_1, GPT_4_1_MINI, GPT_4_1_NANO, DEEPSEEK_V4_FLASH, MISTRAL_LARGE_3, MICROSOFT_DECISION_1
parallel	boolean	Führt Suchentscheidung und Suchumformulierung gleichzeitig aus.
decisionPrompt	string	Regeln für die Entscheidung, ob in der Knowledge Base gesucht wird: SEARCH oder SKIP.
rewritePrompt	string	Anweisungen zur Umformulierung der Wissenssuchanfrage.

{
  "id": "00000000-0000-0000-0000-000000000001",
  "revision": "revision-from-get",
  "agent": {
    "enabled": false,
    "agentType": "VOICE",
    "title": "Demo",
    "description": "string",
    "agentName": "Demo Assistant",
    "persona": "string",
    "sttLanguages": [
      "de-DE"
    ],
    "voiceId": "azure:FLORIAN_HD",
    "voiceConfiguration": {
      "temperature": 0.3,
      "topP": 0.3,
      "topK": 1,
      "cfgScale": 1,
      "telecomEffectEnabled": false,
      "enhancePronunciationEnabled": false,
      "xmlLang": "de-AT",
      "style": "string"
    },
    "greetingMorningText": "string",
    "greetingAfternoonText": "string",
    "greetingEveningText": "string",
    "importantNote": "string",
    "initialSilenceTimeoutMs": 1500,
    "segmentationSilenceTimeoutMs": 500,
    "phraseList": [
      "Nuvoca"
    ],
    "timezone": "Europe/Berlin",
    "greetingNonInterruptible": false,
    "greetingTimeoutSeconds": 30,
    "sttProvider": "AZURE",
    "deepgramEotThreshold": 0.5,
    "deepgramEotTimeoutMs": 500,
    "deepgramLanguageHints": [],
    "preferPreProcessingGreeting": false,
    "kugelLanguages": [
      "string"
    ],
    "kugelTurnDetectionLevel": "RESPONSIVE"
  },
  "options": {
    "model": "GPT_4_1_MINI",
    "reasoningEffort": "NONE",
    "systemPrompt": "string",
    "conversationHistoryLimit": 20,
    "knowledgeBaseId": "00000000-0000-0000-0000-000000000001",
    "ragTopK": 5,
    "ragSimilarityThreshold": 0.5,
    "temperature": 0.3,
    "maxTokens": 1000,
    "ttsStreamingMode": "QUALITY_SSML",
    "queryTransformEnabled": false,
    "queryTransformHistoryLimit": 5,
    "queryTransformPrompt": "string",
    "queryTransformConfidenceThreshold": 0.8,
    "queryTransformMode": "LLM",
    "decisionQueryTransform": {
      "rewriteModel": "GPT_4_1_MINI",
      "parallel": false,
      "decisionPrompt": "string",
      "rewritePrompt": "string"
    }
  }
}

Fehlerantworten

Status	Bedeutung
400	Ungültige Eingabe, Auswahl oder Zeitgrenzen.
401	Fehlender, abgelaufener oder ungültiger Zugang. Der Body kann leer sein.
403	Benötigter Scope oder aktuelles Benutzerrecht fehlt. Der Body kann leer sein.
404	Ressource im gebundenen Workspace nicht verfügbar.
429	Gemeinsames Workspace-Budget überschritten. Retry-After abwarten; unklare Schreibvorgänge nicht blind wiederholen.
503	Vorübergehend nicht verfügbar. Unklare Schreibvorgänge vor erneutem Versuch prüfen.

Fehler-Body

Feld	Typ	Beschreibung
status	integer	HTTP-Statuscode.
error	string	Beschreibung des Fehlers.
details	any	Weitere Fehlerdetails, sofern vorhanden. Regeln: null erlaubt
code	string	Maschinenlesbarer Fehlercode.
params	object	Zusätzliche Werte zum Fehlercode.
fieldErrors	object	Validierungsfehler nach Eingabefeld.

Bei 429 oder 503 den Header Retry-After (Sekunden) beachten. Unklare Schreibvorgänge vor einem neuen Versuch prüfen.

Agent ändern

PUT /api/external/v1/agents/{id}

Scope: agents:write

Speichert die Konfiguration direkt; führt keinen Anruf, Tooltest oder Nachrichtenversand aus. Ressource zuerst lesen. Den aktuellen ETag einschließlich Anführungszeichen als If-Match senden. Vollständige bearbeitbare Konfiguration senden. Ausgelassene Einstellungen können zurückgesetzt werden.

Parameter

Name	Position	Typ	Pflicht	Beschreibung
id	Pfad	string (uuid)	Ja	Ressourcen-ID im gebundenen Workspace.
If-Match	Header	string	Ja	ETag aus dem vorherigen Leseaufruf einschließlich Anführungszeichen. Beispiel: "revision-from-get"

Request-Body · application/json

FelderBeispiel

Feld	Typ	Pflicht	Beschreibung
agent	object	Ja	Einstellungen für Gespräch, Spracherkennung und Stimme.
options	object	Ja	Einstellungen für Modell, Prompt und Wissenssuche.

agent — Felder

Feld	Typ	Pflicht	Beschreibung
enabled	boolean	Nein	Aktiviert den Agent. Auslassen oder null bedeutet false.
agentType	string	Ja	VOICE führt Telefongespräche; AGENTIC ist ein Fachagent in einem Agentic Flow. Werte: AGENTIC, VOICE
title	string	Ja	Anzeigename der Ressource. Regeln: höchstens 255 Zeichen Beispiel: "Demo"
description	string	Nein	Beschreibung des Zwecks dieser Ressource. Regeln: höchstens 10000 Zeichen; null erlaubt
agentName	string	Ja	Name, mit dem sich der Agent im Gespräch vorstellt. Regeln: höchstens 255 Zeichen Beispiel: "Demo Assistant"
persona	string	Nein	Persönlichkeit und Sprechstil des Agents. Regeln: höchstens 10000 Zeichen; null erlaubt
sttLanguages	Liste von string	Ja	Sprachen, die Azure erkennen soll. Bei einem anderen Spracherkennungsanbieter bleiben die Werte gespeichert. Regeln: mindestens 1 Eintrag; keine doppelten Einträge Beispiel: ["de-DE"] Alle 85 erlaubten Werte anzeigen de-DE, de-AT, de-CH, en-US, en-GB, en-AU, en-CA, en-IE, en-IN, es-ES, es-MX, fr-FR, fr-CA, nl-NL, nl-BE, pt-BR, pt-PT, ja-JP, zh-CN, zh-HK, it-IT, pl-PL, cs-CZ, da-DK, sv-SE, fi-FI, el-GR, ru-RU, tr-TR, ar-EG, af-ZA, am-ET, hy-AM, az-AZ, bn-IN, bs-BA, bg-BG, ca-ES, hr-HR, et-EE, fa-IR, fil-PH, ka-GE, gl-ES, gu-IN, he-IL, hi-IN, hu-HU, is-IS, id-ID, jv-ID, kn-IN, kk-KZ, km-KH, ko-KR, lo-LA, lt-LT, lv-LV, mk-MK, ms-MY, mt-MT, mn-MN, nb-NO, ne-NP, pa-IN, ps-AF, sw-KE, ta-IN, te-IN, th-TH, uk-UA, ur-PK, uz-UZ, vi-VN, sr-RS, sq-AL, so-SO, sl-SI, sk-SK, si-LK, ro-RO, my-MM, ml-IN, ga-IE, cy-GB
voiceId	string	Ja	Exakte ID aus dem Stimmenkatalog einschließlich Anbieterpräfix. Regeln: höchstens 255 Zeichen
voiceConfiguration	object	Nein	Von der gewählten Stimme unterstützte Parameter. null entfernt sie beim Agent-Update.
greetingMorningText	string	Ja	Begrüßung am Morgen gemäß der Zeitzone des Agents. Regeln: höchstens 4000 Zeichen
greetingAfternoonText	string	Ja	Begrüßung am Nachmittag gemäß der Zeitzone des Agents. Regeln: höchstens 4000 Zeichen
greetingEveningText	string	Ja	Begrüßung am Abend gemäß der Zeitzone des Agents. Regeln: höchstens 4000 Zeichen
importantNote	string	Nein	Zusätzliche Anweisungen für den Agent. Regeln: höchstens 10000 Zeichen; null erlaubt
initialSilenceTimeoutMs	integer (int32)	Ja	Wie lange Azure auf den Beginn einer Äußerung wartet, in Millisekunden. Regeln: 0–60000 Beispiel: 1500
segmentationSilenceTimeoutMs	integer (int32)	Ja	Stille, nach der Azure erkannte Sprache in Abschnitte trennt, in Millisekunden. Regeln: 100–5000 Beispiel: 500
phraseList	Liste von string	Nein	Wörter oder Ausdrücke als Erkennungshilfe, etwa Produktnamen. Als einzelne Listeneinträge senden, nicht als kommagetrennten Text. Regeln: höchstens 500 Einträge; null erlaubt Beispiel: ["Nuvoca"] Je Eintrag: höchstens 500 Zeichen
timezone	string	Nein	IANA-Zeitzone für zeitabhängiges Agent-Verhalten, etwa Europe/Berlin. Regeln: höchstens 100 Zeichen; null erlaubt Beispiel: "Europe/Berlin"
greetingNonInterruptible	boolean	Nein	Verhindert, dass der Anrufer die Begrüßung unterbricht. Regeln: null erlaubt
greetingTimeoutSeconds	integer (int32)	Nein	Zeitlimit für die Begrüßung, in Sekunden. Regeln: 5–300; null erlaubt Beispiel: 30
sttProvider	string	Nein	Spracherkennungsanbieter aus dem Agent-Katalog. Regeln: null erlaubt Werte: AZURE, DEEPGRAM, KUGEL
deepgramEotThreshold	number	Nein	Konfidenz, ab der Deepgram den Gesprächsbeitrag als beendet einstuft. Regeln: 0.5–0.9; null erlaubt
deepgramEotTimeoutMs	integer (int32)	Nein	Deepgram-Zeitlimit für das Erkennen des Beitragsendes, in Millisekunden. Regeln: 500–10000; null erlaubt
deepgramLanguageHints	Liste von string	Nein	Sprachhinweise aus dem Agent-Katalog. Sie gewichten die Deepgram-Erkennung, ohne die unterstützten Sprachen einzuschränken. Regeln: keine doppelten Einträge; null erlaubt Alle 10 erlaubten Werte anzeigen de, en, es, fr, hi, it, ja, nl, pt, ru
preferPreProcessingGreeting	boolean	Nein	Verwendet die Begrüßung aus dem Pre Processing, sofern sie vorliegt. Regeln: null erlaubt
kugelLanguages	Liste von string	Nein	Geordnete Kugel-Sprachcodes aus dem Agent-Katalog. Die erste Sprache wird zu Gesprächsbeginn erwartet. Beim Anlegen gilt standardmäßig Deutsch; Auslassen beim Update behält die Liste. Regeln: 1–9 Einträge; null erlaubt
kugelTurnDetectionLevel	string	Nein	RESPONSIVE reagiert zügig; CONSERVATIVE wartet bei Denkpausen länger. Gilt für neue Anrufe; Auslassen beim Update behält die Einstellung. Regeln: null erlaubt Werte: RESPONSIVE, CONSERVATIVE

voiceConfiguration — Felder

Feld	Typ	Pflicht	Beschreibung
temperature	number (double)	Nein	Sampling-Temperatur der Stimme. Niedrigere Werte erzeugen gleichmäßigere Sprache. Regeln: 0.3–1; null erlaubt
topP	number (double)	Nein	Top-p-Sampling-Einstellung, sofern von der Stimme unterstützt. Regeln: 0.3–1; null erlaubt
topK	integer (int32)	Nein	Top-k-Sampling-Einstellung, sofern von der Stimme unterstützt. Regeln: 1–50; null erlaubt
cfgScale	number (double)	Nein	Stärke der Stimmsteuerung, sofern die Stimme diesen Parameter unterstützt. Regeln: 1–2; null erlaubt
telecomEffectEnabled	boolean	Nein	Aktiviert Telefonklang für unterstützte Azure-HD-Stimmen. null verwendet den Plattformstandard.
enhancePronunciationEnabled	boolean	Nein	Aktiviert die Ausspracheverfeinerung für unterstützte Azure-HD-Stimmen. null verwendet den Plattformstandard.
xmlLang	string	Nein	Von der gewählten Stimme unterstützter Sprach- oder Akzentcode. Regeln: höchstens 10 Zeichen; null erlaubt Beispiel: "de-AT"
style	string	Nein	Von der gewählten Stimme unterstützter Sprechstil. Regeln: höchstens 50 Zeichen; null erlaubt

options — Felder

Feld	Typ	Pflicht	Beschreibung
model	string	Ja	Agent-Modell aus dem Agent-Katalog. Reasoning-, Temperatur- und Outputgrenzen des Eintrags beachten. Alle 19 erlaubten Werte anzeigen GPT_6_1_SOL, GPT_6_1_TERRA, GPT_6_SOL, GPT_6_LUNA, GPT_5_6_SOL, GPT_5_6_TERRA, GPT_5_6_LUNA, GPT_5, GPT_5_MINI, GPT_5_NANO, GPT_5_4, GPT_5_4_MINI, GPT_5_4_NANO, GPT_4_1, GPT_4_1_MINI, GPT_4_1_NANO, DEEPSEEK_V4_FLASH, MISTRAL_LARGE_3, MICROSOFT_DECISION_1
reasoningEffort	string	Nein	Vom gewählten Modell unterstützter Reasoning-Aufwand gemäß Agent-Katalog. Werte: NONE, MINIMAL, LOW
systemPrompt	string	Ja	Vollständige Agent-Anweisungen einschließlich Verhalten, Wissensgrenzen und Fehlerbehandlung. Regeln: höchstens 100000 Zeichen
conversationHistoryLimit	integer (int32)	Ja	Maximale Anzahl der Gesprächsverlaufseinträge für das Modell. Regeln: 1–100 Beispiel: 20
knowledgeBaseId	string (uuid)	Nein	ID der zugeordneten Knowledge Base. null entfernt die Zuordnung.
ragTopK	integer (int32)	Ja	Maximale Anzahl abgerufener Wissensabschnitte pro Suche. Regeln: 1–50 Beispiel: 5
ragSimilarityThreshold	number (double)	Nein	Mindestähnlichkeit eines Wissensabschnitts, damit er berücksichtigt wird. Regeln: 0–1 Beispiel: 0.5
temperature	number (double)	Nein	Variation der Antworten. Eine feste Temperatur im Katalogeintrag des Modells beachten. Regeln: 0–2 Beispiel: 0.3
maxTokens	integer (int32)	Ja	Maximales Output-Tokenbudget. Zusätzlich die Grenze des gewählten Modells im Katalog beachten. Regeln: 10–25000 Beispiel: 1000
ttsStreamingMode	string	Nein	Sprachausgabemodus aus dem Agent-Katalog. Werte: QUALITY_SSML, LOW_LATENCY_TEXT_STREAM
queryTransformEnabled	boolean	Nein	Formuliert Wissenssuchanfragen vor der Suche um. Auslassen oder null bedeutet false.
queryTransformHistoryLimit	integer (int32)	Ja	Maximale Anzahl der Gesprächsverlaufseinträge für die Suchumformulierung. Regeln: 1–100 Beispiel: 5
queryTransformPrompt	string	Nein	Prompt zur Suchumformulierung im LLM-Modus. DECISION verwendet decisionQueryTransform. Regeln: höchstens 20000 Zeichen
queryTransformConfidenceThreshold	number (double)	Nein	Erforderliche Konfidenz für die Suchumformulierung. Regeln: 0–1 Beispiel: 0.8
queryTransformMode	string	Nein	Verwendet eine LLM-Umformulierung oder einen separaten Suchentscheid mit Umformulierung. Werte: LLM, DECISION
decisionQueryTransform	object	Nein	Einstellungen für Suchentscheidung und Suchumformulierung. Die Funktion muss im Agent-Katalog verfügbar sein.

decisionQueryTransform — Felder

Feld	Typ	Pflicht	Beschreibung
rewriteModel	string	Nein	Modell zur Suchumformulierung. Im Katalog ein Modell mit supportsQueryRewrite=true wählen. Alle 19 erlaubten Werte anzeigen GPT_6_1_SOL, GPT_6_1_TERRA, GPT_6_SOL, GPT_6_LUNA, GPT_5_6_SOL, GPT_5_6_TERRA, GPT_5_6_LUNA, GPT_5, GPT_5_MINI, GPT_5_NANO, GPT_5_4, GPT_5_4_MINI, GPT_5_4_NANO, GPT_4_1, GPT_4_1_MINI, GPT_4_1_NANO, DEEPSEEK_V4_FLASH, MISTRAL_LARGE_3, MICROSOFT_DECISION_1
parallel	boolean	Nein	Führt Suchentscheidung und Suchumformulierung gleichzeitig aus.
decisionPrompt	string	Nein	Regeln für die Entscheidung, ob in der Knowledge Base gesucht wird: SEARCH oder SKIP.
rewritePrompt	string	Nein	Anweisungen zur Umformulierung der Wissenssuchanfrage.

{
  "agent": {
    "enabled": false,
    "agentType": "VOICE",
    "title": "NuvoCar Empfang – Entwurf",
    "agentName": "NuvoCar Assistent",
    "sttProvider": "AZURE",
    "sttLanguages": [
      "de-DE"
    ],
    "voiceId": "azure:FLORIAN_HD",
    "timezone": "Europe/Berlin",
    "greetingMorningText": "Guten Morgen, hier ist der digitale Assistent von NuvoCar. Wie kann ich helfen?",
    "greetingAfternoonText": "Guten Tag, hier ist der digitale Assistent von NuvoCar. Wie kann ich helfen?",
    "greetingEveningText": "Guten Abend, hier ist der digitale Assistent von NuvoCar. Wie kann ich helfen?",
    "initialSilenceTimeoutMs": 1500,
    "segmentationSilenceTimeoutMs": 500,
    "phraseList": [
      "NuvoCar"
    ]
  },
  "options": {
    "model": "GPT_4_1_MINI",
    "systemPrompt": "Du bist der digitale Empfang von NuvoCar. Frage nach dem Anliegen. Erfinde keine Preise oder Termine. Erkläre offen, wenn eine Auskunft fehlt. Behaupte keine Speicherung oder Weiterleitung ohne erfolgreiche konfigurierte Aktion.",
    "conversationHistoryLimit": 20,
    "knowledgeBaseId": null,
    "ragTopK": 5,
    "ragSimilarityThreshold": 0.5,
    "temperature": 0.3,
    "maxTokens": 1000,
    "ttsStreamingMode": "QUALITY_SSML",
    "queryTransformEnabled": false,
    "queryTransformHistoryLimit": 5,
    "queryTransformConfidenceThreshold": 0.8,
    "queryTransformMode": "LLM"
  }
}

Antwort 200

Erfolgreich.

Header	Typ	Beschreibung
Cache-Control	string	Die Antwort darf nicht zwischengespeichert werden. Beispiel: no-store
ETag	string	Aktuelle Revision. Bei erforderlichem If-Match unverändert einschließlich Anführungszeichen senden. Beispiel: "revision-from-get"

application/json

FelderBeispiel

Feld	Typ	Beschreibung
id	string (uuid)	Ressourcen-ID in deinem Workspace.
revision	string	Aktuelle Ressourcenrevision. Beim Ändern den ETag der Antwort als If-Match senden.
agent	object	Einstellungen für Gespräch, Spracherkennung und Stimme.
options	object	Einstellungen für Modell, Prompt und Wissenssuche.

agent — Felder

Feld	Typ	Beschreibung
enabled	boolean	Aktiviert den Agent. Auslassen oder null bedeutet false.
agentType	string	VOICE führt Telefongespräche; AGENTIC ist ein Fachagent in einem Agentic Flow. Werte: AGENTIC, VOICE
title	string	Anzeigename der Ressource. Regeln: höchstens 255 Zeichen Beispiel: "Demo"
description	string	Beschreibung des Zwecks dieser Ressource. Regeln: höchstens 10000 Zeichen; null erlaubt
agentName	string	Name, mit dem sich der Agent im Gespräch vorstellt. Regeln: höchstens 255 Zeichen Beispiel: "Demo Assistant"
persona	string	Persönlichkeit und Sprechstil des Agents. Regeln: höchstens 10000 Zeichen; null erlaubt
sttLanguages	Liste von string	Sprachen, die Azure erkennen soll. Bei einem anderen Spracherkennungsanbieter bleiben die Werte gespeichert. Regeln: mindestens 1 Eintrag; keine doppelten Einträge Beispiel: ["de-DE"] Alle 85 erlaubten Werte anzeigen de-DE, de-AT, de-CH, en-US, en-GB, en-AU, en-CA, en-IE, en-IN, es-ES, es-MX, fr-FR, fr-CA, nl-NL, nl-BE, pt-BR, pt-PT, ja-JP, zh-CN, zh-HK, it-IT, pl-PL, cs-CZ, da-DK, sv-SE, fi-FI, el-GR, ru-RU, tr-TR, ar-EG, af-ZA, am-ET, hy-AM, az-AZ, bn-IN, bs-BA, bg-BG, ca-ES, hr-HR, et-EE, fa-IR, fil-PH, ka-GE, gl-ES, gu-IN, he-IL, hi-IN, hu-HU, is-IS, id-ID, jv-ID, kn-IN, kk-KZ, km-KH, ko-KR, lo-LA, lt-LT, lv-LV, mk-MK, ms-MY, mt-MT, mn-MN, nb-NO, ne-NP, pa-IN, ps-AF, sw-KE, ta-IN, te-IN, th-TH, uk-UA, ur-PK, uz-UZ, vi-VN, sr-RS, sq-AL, so-SO, sl-SI, sk-SK, si-LK, ro-RO, my-MM, ml-IN, ga-IE, cy-GB
voiceId	string	Exakte ID aus dem Stimmenkatalog einschließlich Anbieterpräfix. Regeln: höchstens 255 Zeichen
voiceConfiguration	object	Von der gewählten Stimme unterstützte Parameter. null entfernt sie beim Agent-Update.
greetingMorningText	string	Begrüßung am Morgen gemäß der Zeitzone des Agents. Regeln: höchstens 4000 Zeichen
greetingAfternoonText	string	Begrüßung am Nachmittag gemäß der Zeitzone des Agents. Regeln: höchstens 4000 Zeichen
greetingEveningText	string	Begrüßung am Abend gemäß der Zeitzone des Agents. Regeln: höchstens 4000 Zeichen
importantNote	string	Zusätzliche Anweisungen für den Agent. Regeln: höchstens 10000 Zeichen; null erlaubt
initialSilenceTimeoutMs	integer (int32)	Wie lange Azure auf den Beginn einer Äußerung wartet, in Millisekunden. Regeln: 0–60000 Beispiel: 1500
segmentationSilenceTimeoutMs	integer (int32)	Stille, nach der Azure erkannte Sprache in Abschnitte trennt, in Millisekunden. Regeln: 100–5000 Beispiel: 500
phraseList	Liste von string	Wörter oder Ausdrücke als Erkennungshilfe, etwa Produktnamen. Als einzelne Listeneinträge senden, nicht als kommagetrennten Text. Regeln: höchstens 500 Einträge; null erlaubt Beispiel: ["Nuvoca"] Je Eintrag: höchstens 500 Zeichen
timezone	string	IANA-Zeitzone für zeitabhängiges Agent-Verhalten, etwa Europe/Berlin. Regeln: höchstens 100 Zeichen; null erlaubt Beispiel: "Europe/Berlin"
greetingNonInterruptible	boolean	Verhindert, dass der Anrufer die Begrüßung unterbricht. Regeln: null erlaubt
greetingTimeoutSeconds	integer (int32)	Zeitlimit für die Begrüßung, in Sekunden. Regeln: 5–300; null erlaubt Beispiel: 30
sttProvider	string	Spracherkennungsanbieter aus dem Agent-Katalog. Regeln: null erlaubt Werte: AZURE, DEEPGRAM, KUGEL
deepgramEotThreshold	number	Konfidenz, ab der Deepgram den Gesprächsbeitrag als beendet einstuft. Regeln: 0.5–0.9; null erlaubt
deepgramEotTimeoutMs	integer (int32)	Deepgram-Zeitlimit für das Erkennen des Beitragsendes, in Millisekunden. Regeln: 500–10000; null erlaubt
deepgramLanguageHints	Liste von string	Sprachhinweise aus dem Agent-Katalog. Sie gewichten die Deepgram-Erkennung, ohne die unterstützten Sprachen einzuschränken. Regeln: keine doppelten Einträge; null erlaubt Alle 10 erlaubten Werte anzeigen de, en, es, fr, hi, it, ja, nl, pt, ru
preferPreProcessingGreeting	boolean	Verwendet die Begrüßung aus dem Pre Processing, sofern sie vorliegt. Regeln: null erlaubt
kugelLanguages	Liste von string	Geordnete Kugel-Sprachcodes aus dem Agent-Katalog. Die erste Sprache wird zu Gesprächsbeginn erwartet. Beim Anlegen gilt standardmäßig Deutsch; Auslassen beim Update behält die Liste. Regeln: 1–9 Einträge; null erlaubt
kugelTurnDetectionLevel	string	RESPONSIVE reagiert zügig; CONSERVATIVE wartet bei Denkpausen länger. Gilt für neue Anrufe; Auslassen beim Update behält die Einstellung. Regeln: null erlaubt Werte: RESPONSIVE, CONSERVATIVE

voiceConfiguration — Felder

Feld	Typ	Beschreibung
temperature	number (double)	Sampling-Temperatur der Stimme. Niedrigere Werte erzeugen gleichmäßigere Sprache. Regeln: 0.3–1; null erlaubt
topP	number (double)	Top-p-Sampling-Einstellung, sofern von der Stimme unterstützt. Regeln: 0.3–1; null erlaubt
topK	integer (int32)	Top-k-Sampling-Einstellung, sofern von der Stimme unterstützt. Regeln: 1–50; null erlaubt
cfgScale	number (double)	Stärke der Stimmsteuerung, sofern die Stimme diesen Parameter unterstützt. Regeln: 1–2; null erlaubt
telecomEffectEnabled	boolean	Aktiviert Telefonklang für unterstützte Azure-HD-Stimmen. null verwendet den Plattformstandard.
enhancePronunciationEnabled	boolean	Aktiviert die Ausspracheverfeinerung für unterstützte Azure-HD-Stimmen. null verwendet den Plattformstandard.
xmlLang	string	Von der gewählten Stimme unterstützter Sprach- oder Akzentcode. Regeln: höchstens 10 Zeichen; null erlaubt Beispiel: "de-AT"
style	string	Von der gewählten Stimme unterstützter Sprechstil. Regeln: höchstens 50 Zeichen; null erlaubt

options — Felder

Feld	Typ	Beschreibung
model	string	Agent-Modell aus dem Agent-Katalog. Reasoning-, Temperatur- und Outputgrenzen des Eintrags beachten. Alle 19 erlaubten Werte anzeigen GPT_6_1_SOL, GPT_6_1_TERRA, GPT_6_SOL, GPT_6_LUNA, GPT_5_6_SOL, GPT_5_6_TERRA, GPT_5_6_LUNA, GPT_5, GPT_5_MINI, GPT_5_NANO, GPT_5_4, GPT_5_4_MINI, GPT_5_4_NANO, GPT_4_1, GPT_4_1_MINI, GPT_4_1_NANO, DEEPSEEK_V4_FLASH, MISTRAL_LARGE_3, MICROSOFT_DECISION_1
reasoningEffort	string	Vom gewählten Modell unterstützter Reasoning-Aufwand gemäß Agent-Katalog. Werte: NONE, MINIMAL, LOW
systemPrompt	string	Vollständige Agent-Anweisungen einschließlich Verhalten, Wissensgrenzen und Fehlerbehandlung. Regeln: höchstens 100000 Zeichen
conversationHistoryLimit	integer (int32)	Maximale Anzahl der Gesprächsverlaufseinträge für das Modell. Regeln: 1–100 Beispiel: 20
knowledgeBaseId	string (uuid)	ID der zugeordneten Knowledge Base. null entfernt die Zuordnung.
ragTopK	integer (int32)	Maximale Anzahl abgerufener Wissensabschnitte pro Suche. Regeln: 1–50 Beispiel: 5
ragSimilarityThreshold	number (double)	Mindestähnlichkeit eines Wissensabschnitts, damit er berücksichtigt wird. Regeln: 0–1 Beispiel: 0.5
temperature	number (double)	Variation der Antworten. Eine feste Temperatur im Katalogeintrag des Modells beachten. Regeln: 0–2 Beispiel: 0.3
maxTokens	integer (int32)	Maximales Output-Tokenbudget. Zusätzlich die Grenze des gewählten Modells im Katalog beachten. Regeln: 10–25000 Beispiel: 1000
ttsStreamingMode	string	Sprachausgabemodus aus dem Agent-Katalog. Werte: QUALITY_SSML, LOW_LATENCY_TEXT_STREAM
queryTransformEnabled	boolean	Formuliert Wissenssuchanfragen vor der Suche um. Auslassen oder null bedeutet false.
queryTransformHistoryLimit	integer (int32)	Maximale Anzahl der Gesprächsverlaufseinträge für die Suchumformulierung. Regeln: 1–100 Beispiel: 5
queryTransformPrompt	string	Prompt zur Suchumformulierung im LLM-Modus. DECISION verwendet decisionQueryTransform. Regeln: höchstens 20000 Zeichen
queryTransformConfidenceThreshold	number (double)	Erforderliche Konfidenz für die Suchumformulierung. Regeln: 0–1 Beispiel: 0.8
queryTransformMode	string	Verwendet eine LLM-Umformulierung oder einen separaten Suchentscheid mit Umformulierung. Werte: LLM, DECISION
decisionQueryTransform	object	Einstellungen für Suchentscheidung und Suchumformulierung. Die Funktion muss im Agent-Katalog verfügbar sein.

decisionQueryTransform — Felder

Feld	Typ	Beschreibung
rewriteModel	string	Modell zur Suchumformulierung. Im Katalog ein Modell mit supportsQueryRewrite=true wählen. Alle 19 erlaubten Werte anzeigen GPT_6_1_SOL, GPT_6_1_TERRA, GPT_6_SOL, GPT_6_LUNA, GPT_5_6_SOL, GPT_5_6_TERRA, GPT_5_6_LUNA, GPT_5, GPT_5_MINI, GPT_5_NANO, GPT_5_4, GPT_5_4_MINI, GPT_5_4_NANO, GPT_4_1, GPT_4_1_MINI, GPT_4_1_NANO, DEEPSEEK_V4_FLASH, MISTRAL_LARGE_3, MICROSOFT_DECISION_1
parallel	boolean	Führt Suchentscheidung und Suchumformulierung gleichzeitig aus.
decisionPrompt	string	Regeln für die Entscheidung, ob in der Knowledge Base gesucht wird: SEARCH oder SKIP.
rewritePrompt	string	Anweisungen zur Umformulierung der Wissenssuchanfrage.

{
  "id": "00000000-0000-0000-0000-000000000001",
  "revision": "revision-from-get",
  "agent": {
    "enabled": false,
    "agentType": "VOICE",
    "title": "Demo",
    "description": "string",
    "agentName": "Demo Assistant",
    "persona": "string",
    "sttLanguages": [
      "de-DE"
    ],
    "voiceId": "azure:FLORIAN_HD",
    "voiceConfiguration": {
      "temperature": 0.3,
      "topP": 0.3,
      "topK": 1,
      "cfgScale": 1,
      "telecomEffectEnabled": false,
      "enhancePronunciationEnabled": false,
      "xmlLang": "de-AT",
      "style": "string"
    },
    "greetingMorningText": "string",
    "greetingAfternoonText": "string",
    "greetingEveningText": "string",
    "importantNote": "string",
    "initialSilenceTimeoutMs": 1500,
    "segmentationSilenceTimeoutMs": 500,
    "phraseList": [
      "Nuvoca"
    ],
    "timezone": "Europe/Berlin",
    "greetingNonInterruptible": false,
    "greetingTimeoutSeconds": 30,
    "sttProvider": "AZURE",
    "deepgramEotThreshold": 0.5,
    "deepgramEotTimeoutMs": 500,
    "deepgramLanguageHints": [],
    "preferPreProcessingGreeting": false,
    "kugelLanguages": [
      "string"
    ],
    "kugelTurnDetectionLevel": "RESPONSIVE"
  },
  "options": {
    "model": "GPT_4_1_MINI",
    "reasoningEffort": "NONE",
    "systemPrompt": "string",
    "conversationHistoryLimit": 20,
    "knowledgeBaseId": "00000000-0000-0000-0000-000000000001",
    "ragTopK": 5,
    "ragSimilarityThreshold": 0.5,
    "temperature": 0.3,
    "maxTokens": 1000,
    "ttsStreamingMode": "QUALITY_SSML",
    "queryTransformEnabled": false,
    "queryTransformHistoryLimit": 5,
    "queryTransformPrompt": "string",
    "queryTransformConfidenceThreshold": 0.8,
    "queryTransformMode": "LLM",
    "decisionQueryTransform": {
      "rewriteModel": "GPT_4_1_MINI",
      "parallel": false,
      "decisionPrompt": "string",
      "rewritePrompt": "string"
    }
  }
}

Fehlerantworten

Status	Bedeutung
400	Ungültige Eingabe, Auswahl oder Zeitgrenzen.
401	Fehlender, abgelaufener oder ungültiger Zugang. Der Body kann leer sein.
403	Benötigter Scope oder aktuelles Benutzerrecht fehlt. Der Body kann leer sein.
404	Ressource im gebundenen Workspace nicht verfügbar.
409	Fehlende/veraltete Revision oder Abhängigkeits-/Routingkonflikt. Vor erneutem Versuch neu lesen.
429	Gemeinsames Workspace-Budget überschritten. Retry-After abwarten; unklare Schreibvorgänge nicht blind wiederholen.
503	Vorübergehend nicht verfügbar. Unklare Schreibvorgänge vor erneutem Versuch prüfen.

Fehler-Body

Feld	Typ	Beschreibung
status	integer	HTTP-Statuscode.
error	string	Beschreibung des Fehlers.
details	any	Weitere Fehlerdetails, sofern vorhanden. Regeln: null erlaubt
code	string	Maschinenlesbarer Fehlercode.
params	object	Zusätzliche Werte zum Fehlercode.
fieldErrors	object	Validierungsfehler nach Eingabefeld.

Bei 429 oder 503 den Header Retry-After (Sekunden) beachten. Unklare Schreibvorgänge vor einem neuen Versuch prüfen.

Bisherigen Agent-Snapshot lesen

GET /api/external/v1/agents/{agentId}/configuration

Scope: agents:configuration:read

Bisheriger reiner Lese-Snapshot. Nutze GET /agents/{id} für die bearbeitbare Konfiguration mit ETag.

Parameter

Name	Position	Typ	Pflicht	Beschreibung
agentId	Pfad	string (uuid)	Ja	Ressourcen-ID im gebundenen Workspace.

Antwort 200

Erfolgreich.

Header	Typ	Beschreibung
Cache-Control	string	Die Antwort darf nicht zwischengespeichert werden. Beispiel: no-store

application/json

FelderBeispiel

Feld	Typ	Beschreibung
agent	object	Einstellungen für Gespräch, Spracherkennung und Stimme.
options	object	Einstellungen für Modell, Prompt und Wissenssuche.

agent — Felder

Feld	Typ	Beschreibung
agentId	string (uuid)	ID des Agents.
tenantId	string (uuid)	ID des mit dem Zugang verbundenen Workspaces.
enabled	boolean	Ob diese Ressource aktiviert ist.
agentType	string	VOICE führt Telefongespräche; AGENTIC ist ein Fachagent in einem Agentic Flow. Werte: AGENTIC, VOICE
title	string	Anzeigename der Ressource.
description	string	Beschreibung des Zwecks dieser Ressource. Regeln: null erlaubt
agentName	string	Name, mit dem sich der Agent im Gespräch vorstellt. Regeln: mindestens 1 Zeichen
persona	string	Persönlichkeit und Sprechstil des Agents. Regeln: null erlaubt
sttLanguages	Liste von string	Sprachen, die Azure erkennen soll. Bei einem anderen Spracherkennungsanbieter bleiben die Werte gespeichert. Regeln: keine doppelten Einträge Alle 85 erlaubten Werte anzeigen de-DE, de-AT, de-CH, en-US, en-GB, en-AU, en-CA, en-IE, en-IN, es-ES, es-MX, fr-FR, fr-CA, nl-NL, nl-BE, pt-BR, pt-PT, ja-JP, zh-CN, zh-HK, it-IT, pl-PL, cs-CZ, da-DK, sv-SE, fi-FI, el-GR, ru-RU, tr-TR, ar-EG, af-ZA, am-ET, hy-AM, az-AZ, bn-IN, bs-BA, bg-BG, ca-ES, hr-HR, et-EE, fa-IR, fil-PH, ka-GE, gl-ES, gu-IN, he-IL, hi-IN, hu-HU, is-IS, id-ID, jv-ID, kn-IN, kk-KZ, km-KH, ko-KR, lo-LA, lt-LT, lv-LV, mk-MK, ms-MY, mt-MT, mn-MN, nb-NO, ne-NP, pa-IN, ps-AF, sw-KE, ta-IN, te-IN, th-TH, uk-UA, ur-PK, uz-UZ, vi-VN, sr-RS, sq-AL, so-SO, sl-SI, sk-SK, si-LK, ro-RO, my-MM, ml-IN, ga-IE, cy-GB
voice	string	Stimmenkennung in der bisherigen Agent-Konfiguration. Alle 714 erlaubten Werte anzeigen KLAUS_MAI_FLASH, MIA_MAI_FLASH, ISLA_MAI_FLASH, ETHAN_MAI_FLASH, GRANT_MAI_FLASH, HARPER_MAI_FLASH, IRIS_MAI_FLASH, JASPER_MAI_FLASH, OLIVIA_MAI_FLASH, MARTA_MAI_FLASH, ALEJO_MAI_FLASH, VALERIA_MAI_FLASH, MARC_MAI_FLASH, SOLEIL_MAI_FLASH, ARJUN_MAI_FLASH, DHRUV_MAI_FLASH, KAVYA_MAI_FLASH, PRIYA_MAI_FLASH, BENCE_MAI_FLASH, LEVENTE_MAI_FLASH, LILLA_MAI_FLASH, REKA_MAI_FLASH, CAHYA_MAI_FLASH, SARI_MAI_FLASH, LUCA_MAI_FLASH, ROSA_MAI_FLASH, HARUTO_MAI_FLASH, SAKURA_MAI_FLASH, HAENA_MAI_FLASH, JUNHO_MAI_FLASH, FLEUR_MAI_FLASH, SANDER_MAI_FLASH, CAIO_MAI_FLASH, LUANA_MAI_FLASH, PEDRO_MAI_FLASH, RAFAEL_MAI_FLASH, RUI_MAI_FLASH, ANDREI_MAI_FLASH, ELENA_MAI_FLASH, IOANA_MAI_FLASH, RADU_MAI_FLASH, LEV_MAI_FLASH, MASHA_MAI_FLASH, KRIT_MAI_FLASH, NATTAPONG_MAI_FLASH, AYDIN_MAI_FLASH, ELIF_MAI_FLASH, LINH_MAI_FLASH, BO_MAI_FLASH, LAN_MAI_FLASH, MEI_MAI_FLASH, WEI_MAI_FLASH, CS_CZ_GRANT_MAI_FLASH, CS_CZ_HARPER_MAI_FLASH, DA_DK_GRANT_MAI_FLASH, DA_DK_HARPER_MAI_FLASH, DE_DE_GRANT_MAI_FLASH, DE_DE_HARPER_MAI_FLASH, EN_GB_EMILY_MAI_FLASH, EN_GB_HARRY_MAI_FLASH, EN_IN_DHRUV_MAI_FLASH, EN_IN_PRIYA_MAI_FLASH, EN_US_SAGE_MAI_FLASH, ES_MX_GRANT_MAI_FLASH, ES_MX_HARPER_MAI_FLASH, FI_FI_GRANT_MAI_FLASH, FI_FI_HARPER_MAI_FLASH, FR_FR_GRANT_MAI_FLASH, FR_FR_HARPER_MAI_FLASH, HI_IN_GRANT_MAI_FLASH, HI_IN_HARPER_MAI_FLASH, HU_HU_GRANT_MAI_FLASH, HU_HU_HARPER_MAI_FLASH, ID_ID_GRANT_MAI_FLASH, ID_ID_HARPER_MAI_FLASH, IT_IT_GRANT_MAI_FLASH, IT_IT_HARPER_MAI_FLASH, KO_KR_GRANT_MAI_FLASH, KO_KR_HARPER_MAI_FLASH, NB_NO_GRANT_MAI_FLASH, NB_NO_HARPER_MAI_FLASH, NL_NL_GRANT_MAI_FLASH, NL_NL_HARPER_MAI_FLASH, PL_PL_GRANT_MAI_FLASH, PL_PL_HARPER_MAI_FLASH, PT_BR_GRANT_MAI_FLASH, PT_BR_HARPER_MAI_FLASH, PT_PT_GRANT_MAI_FLASH, PT_PT_HARPER_MAI_FLASH, RO_RO_GRANT_MAI_FLASH, RO_RO_HARPER_MAI_FLASH, RU_RU_GRANT_MAI_FLASH, RU_RU_HARPER_MAI_FLASH, SV_SE_GRANT_MAI_FLASH, SV_SE_HARPER_MAI_FLASH, TH_TH_GRANT_MAI_FLASH, TH_TH_HARPER_MAI_FLASH, TR_TR_GRANT_MAI_FLASH, TR_TR_HARPER_MAI_FLASH, VI_VN_GRANT_MAI_FLASH, VI_VN_HARPER_MAI_FLASH, ZH_CN_GRANT_MAI_FLASH, ZH_CN_HARPER_MAI_FLASH, CS_CZ_GRANT_MAI_21, CS_CZ_HARPER_MAI_21, DA_DK_GRANT_MAI_21, DA_DK_HARPER_MAI_21, DE_DE_GRANT_MAI_21, DE_DE_HARPER_MAI_21, DE_DE_KLAUS_MAI_21, DE_DE_MIA_MAI_21, EN_AU_ISLA_MAI_21, EN_GB_EMILY_MAI_21, EN_GB_HARRY_MAI_21, EN_IN_DHRUV_MAI_21, EN_IN_PRIYA_MAI_21, EN_US_ETHAN_MAI_21, EN_US_GRANT_MAI_21, EN_US_HARPER_MAI_21, EN_US_IRIS_MAI_21, EN_US_JASPER_MAI_21, EN_US_OLIVIA_MAI_21, EN_US_SAGE_MAI_21, ES_ES_MARTA_MAI_21, ES_MX_ALEJO_MAI_21, ES_MX_GRANT_MAI_21, ES_MX_HARPER_MAI_21, ES_MX_VALERIA_MAI_21, FI_FI_GRANT_MAI_21, FI_FI_HARPER_MAI_21, FR_FR_GRANT_MAI_21, FR_FR_HARPER_MAI_21, FR_FR_MARC_MAI_21, FR_FR_SOLEIL_MAI_21, HI_IN_ARJUN_MAI_21, HI_IN_DHRUV_MAI_21, HI_IN_GRANT_MAI_21, HI_IN_HARPER_MAI_21, HI_IN_KAVYA_MAI_21, HI_IN_PRIYA_MAI_21, HU_HU_BENCE_MAI_21, HU_HU_GRANT_MAI_21, HU_HU_HARPER_MAI_21, HU_HU_LEVENTE_MAI_21, HU_HU_LILLA_MAI_21, HU_HU_REKA_MAI_21, ID_ID_GRANT_MAI_21, ID_ID_HARPER_MAI_21, IT_IT_GRANT_MAI_21, IT_IT_HARPER_MAI_21, IT_IT_LUCA_MAI_21, IT_IT_ROSA_MAI_21, KO_KR_GRANT_MAI_21, KO_KR_HAENA_MAI_21, KO_KR_HARPER_MAI_21, KO_KR_JUNHO_MAI_21, NB_NO_GRANT_MAI_21, NB_NO_HARPER_MAI_21, NL_NL_GRANT_MAI_21, NL_NL_HARPER_MAI_21, NL_NL_SANDER_MAI_21, PL_PL_GRANT_MAI_21, PL_PL_HARPER_MAI_21, PT_BR_CAIO_MAI_21, PT_BR_GRANT_MAI_21, PT_BR_HARPER_MAI_21, PT_BR_LUANA_MAI_21, PT_BR_PEDRO_MAI_21, PT_BR_RAFAEL_MAI_21, PT_PT_GRANT_MAI_21, PT_PT_HARPER_MAI_21, PT_PT_RUI_MAI_21, RO_RO_ANDREI_MAI_21, RO_RO_ELENA_MAI_21, RO_RO_GRANT_MAI_21, RO_RO_HARPER_MAI_21, RO_RO_IOANA_MAI_21, RO_RO_RADU_MAI_21, RU_RU_GRANT_MAI_21, RU_RU_HARPER_MAI_21, RU_RU_LEV_MAI_21, RU_RU_MASHA_MAI_21, SV_SE_GRANT_MAI_21, SV_SE_HARPER_MAI_21, TH_TH_GRANT_MAI_21, TH_TH_HARPER_MAI_21, TH_TH_KRIT_MAI_21, TH_TH_NATTAPONG_MAI_21, TR_TR_AYDIN_MAI_21, TR_TR_ELIF_MAI_21, TR_TR_GRANT_MAI_21, TR_TR_HARPER_MAI_21, VI_VN_GRANT_MAI_21, VI_VN_HARPER_MAI_21, ZH_CN_BO_MAI_21, ZH_CN_GRANT_MAI_21, ZH_CN_HARPER_MAI_21, ZH_CN_LAN_MAI_21, ZH_CN_MEI_MAI_21, ZH_CN_WEI_MAI_21, ADRI_OMNI, WILLEM_OMNI, AMEHA_OMNI, MEKDES_OMNI, FATIMA_OMNI, HAMDAN_OMNI, ALI_OMNI, LAILA_OMNI, AMINA_OMNI, ISMAEL_OMNI, SALEH_OMNI, SALMA_OMNI, SHAKIR_OMNI, BASSEL_OMNI, RANA_OMNI, SANA_OMNI, TAIM_OMNI, FAHED_OMNI, NOURA_OMNI, LAYLA_OMNI, RAMI_OMNI, IMAN_OMNI, OMAR_OMNI, JAMAL_OMNI, MOUNA_OMNI, ABDULLAH_OMNI, AMAL_OMNI, MOAZ_OMNI, HAMED_OMNI, ZARIYAH_OMNI, LAITH_OMNI, HEDI_OMNI, BABEK_OMNI, BANU_OMNI, KALINA_OMNI, BASHKAR_OMNI, TANISHAA_OMNI, GORAN_OMNI, VESNA_OMNI, ALBA_OMNI, ENRIC_OMNI, JOANA_OMNI, ANTONIN_OMNI, VLASTA_OMNI, ALED_OMNI, NIA_OMNI, CHRISTEL_OMNI, JEPPE_OMNI, INGRID_OMNI, JAN_OMNI, LENI_OMNI, AMALA_OMNI, BERND_OMNI, CHRISTOPH_OMNI, CONRAD_OMNI, ELKE_OMNI, FLORIAN_OMNI, FLORIAN_HD, KASPER_OMNI, KILLIAN_OMNI, KLARISSA_OMNI, KLAUS_OMNI, LOUISA_OMNI, MAJA_OMNI, OLIVACANTIQUE_OMNI, PERLANAMI_OMNI, RALF_OMNI, SERAPHINA_OMNI, SERAPHINA_HD, TANJA_OMNI, ATHINA_OMNI, NESTORAS_OMNI, ANNETTE_OMNI, DARREN_OMNI, DUNCAN_OMNI, ELSIE_OMNI, FREYA_OMNI, JOANNE_OMNI, KEN_OMNI, KIM_OMNI, NATASHA_OMNI, NEIL_OMNI, TIM_OMNI, TINA_OMNI, WILLIAM_OMNI, CLARA_OMNI, LIAM_OMNI, ADA_OMNI, ALFIE_OMNI, AMARILLOMIRFAK_OMNI, AZABACHETITICACA_OMNI, BELLA_OMNI, ELLIOT_OMNI, ETHAN_OMNI, LIBBY_OMNI, NACARAEGEAN_OMNI, NOAH_OMNI, OLIVER_OMNI, OLIVIA_OMNI, OLLIE_OMNI, RUBIGANGES_OMNI, RYAN_OMNI, SANDOVERTURE_OMNI, THOMAS_OMNI, SAM_OMNI, YAN_OMNI, EMILY_OMNI, AARAV_OMNI, AARTI_OMNI, AASHI_OMNI, ANANYA_OMNI, ARJUN_OMNI, KAVYA_OMNI, KUNAL_OMNI, NEERJA_OMNI, PRABHAT_OMNI, REHAAN_OMNI, ASILIA_OMNI, CHILEMBA_OMNI, ABEO_OMNI, EZINNE_OMNI, MITCHELL_OMNI, MOLLY_OMNI, JAMES_OMNI, ROSA_OMNI, LUNA_OMNI, WAYNE_OMNI, ELIMU_OMNI, IMANI_OMNI, ADAM_OMNI, ALLOY_OMNI, AMANDA_OMNI, AMBER_OMNI, ANDREW_OMNI, ARIA_OMNI, AVA_OMNI, AZABACHESTRATUS_OMNI, AZULLEGATO_OMNI, BRANDON_OMNI, BRIAN_OMNI, CALEB_OMNI, CHARCOALSOLARIA_OMNI, CHRISTOPHER_OMNI, CRIMSONMODERATO_OMNI, DANA_OMNI, DUSTIN_OMNI, ECHO_OMNI, ELIZABETH_OMNI, EMMA_OMNI, ERIC_OMNI, GRISADAMANT_OMNI, JANE_OMNI, JASON_OMNI, KAI_OMNI, LEMONNEBULA_OMNI, LOLA_OMNI, LUNA_US_OMNI, MARIN_OMNI, MOSTAZAPENUMBRA_OMNI, NANCY_OMNI, ONYX_OMNI, PEACHSHANNON_OMNI, PEWTERMALACHITE_OMNI, PISTACHETHYME_OMNI, ROGER_OMNI, ROUGEPEARL_OMNI, RUBICALIMA_OMNI, SAMUEL_OMNI, SANDCADENZA_OMNI, SANDCHILI_OMNI, SHIMMER_OMNI, SLATENEBULIS_OMNI, TONY_OMNI, TURQUOISECREPUSCULO_OMNI, VIOLETVIVACE_OMNI, LEAH_OMNI, LUKE_OMNI, ELENA_OMNI, TOMAS_OMNI, MARCELO_OMNI, SOFIA_OMNI, CATALINA_OMNI, LORENZO_OMNI, GONZALO_OMNI, SALOME_OMNI, JUAN_OMNI, MARIA_OMNI, BELKYS_OMNI, MANUEL_OMNI, EMILIO_OMNI, RAMONA_OMNI, LUIS_OMNI, ABRIL_OMNI, ARABELLA_OMNI, ARNAU_OMNI, BLEUETGANGES_OMNI, ELIAS_OMNI, ELVIRA_OMNI, ESTRELLA_OMNI, GRAPHITEGARDA_OMNI, JAVIER_OMNI, LAIA_OMNI, NIL_OMNI, SAUL_OMNI, SLATEOLA_OMNI, TEO_OMNI, TRIANA_OMNI, VERA_OMNI, ANDRES_OMNI, CARLOS_OMNI, KARLA_OMNI, AMARILLOYUKI_OMNI, BEATRIZ_OMNI, BLUSHVINAGRE_OMNI, CANDELA_OMNI, CARLOTA_OMNI, CECILIO_OMNI, CORALPASTEQUE_OMNI, GERARDO_OMNI, GRISPERLEFRAISE_OMNI, INDIGODIMINUENDO_OMNI, LARISSA_OMNI, LIBERTO_OMNI, LUCIANO_OMNI, MAGENTAHORIZONTE_OMNI, MANDARINAFUYU_OMNI, NOIRFRAISE_OMNI, NURIA_OMNI, PELAYO_OMNI, RENATA_OMNI, SAFIROTASMAN_OMNI, VERDEPOIRE_OMNI, YAGO_OMNI, FEDERICO_OMNI, YOLANDA_OMNI, MARGARITA_OMNI, ROBERTO_OMNI, ALEX_OMNI, CAMILA_OMNI, KARINA_OMNI, VICTOR_OMNI, MARIO_OMNI, TANIA_OMNI, LORENA_OMNI, RODRIGO_OMNI, ALONSO_OMNI, PALOMA_OMNI, MATEO_OMNI, VALENTINA_OMNI, PAOLA_OMNI, SEBASTIAN_OMNI, ANU_OMNI, KERT_OMNI, DILARA_OMNI, FARID_OMNI, HARRI_OMNI, NOORA_OMNI, SELMA_OMNI, ANGELO_OMNI, BLESSICA_OMNI, CHARLINE_OMNI, GERARD_OMNI, ANTOINE_OMNI, JEAN_OMNI, SYLVIE_OMNI, THIERRY_OMNI, ARIANE_OMNI, FABRICE_OMNI, ALAIN_OMNI, BRIGITTE_OMNI, CARAMELOTSUKI_OMNI, CELESTE_OMNI, CELESTESEL_OMNI, CLAUDE_OMNI, CORALIE_OMNI, DENISE_OMNI, JACQUELINE_OMNI, JEROME_OMNI, JOSEPHINE_OMNI, LUCIEN_OMNI, MAURICE_OMNI, REMY_OMNI, VIVIENNE_OMNI, YVES_OMNI, COLM_OMNI, ORLA_OMNI, ROI_OMNI, SABELA_OMNI, DHWANI_OMNI, NIRANJAN_OMNI, AVRI_OMNI, HILA_OMNI, AARAV_HI_OMNI, AARTI_HI_OMNI, ANANYA_HI_OMNI, ARJUN_HI_OMNI, HEERA_OMNI, KAVYA_HI_OMNI, KUNAL_HI_OMNI, MADHUR_OMNI, REHAAN_HI_OMNI, SWARA_OMNI, GABRIJELA_OMNI, NOEMI_OMNI, ANAHIT_OMNI, HAYK_OMNI, ARDI_OMNI, GADIS_OMNI, PRUNEARPEGGIO_OMNI, GUDRUN_OMNI, GUNNAR_OMNI, ALESSIO_OMNI, BENIGNO_OMNI, CALIMERO_OMNI, FABIOLA_OMNI, FIAMMA_OMNI, GIANNI_OMNI, IMELDA_OMNI, IRMA_OMNI, ISABELLA_OMNI, LISANDRO_OMNI, MARCELLO_OMNI, PALMIRA_OMNI, RINALDO_OMNI, DAICHI_OMNI, KEITA_OMNI, MASARU_OMNI, NAOKI_OMNI, SAFRANSAIMAA_OMNI, SHIORI_OMNI, SLATEADRIATIC_OMNI, DIMAS_OMNI, SITI_OMNI, EKA_OMNI, GIORGI_OMNI, AIGUL_OMNI, DAULET_OMNI, PISETH_OMNI, SREYMOM_OMNI, GAGAN_OMNI, SAPNA_OMNI, BONGJIN_OMNI, GOOKMIN_OMNI, INJOON_OMNI, JIMIN_OMNI, MARFILSTEEL_OMNI, MOCHACANNELLE_OMNI, YUJIN_OMNI, CHANTHAVONG_OMNI, KEOMANY_OMNI, LEONAS_OMNI, ONA_OMNI, EVERITA_OMNI, NILS_OMNI, ALEKSANDAR_OMNI, MARIJA_OMNI, MIDHUN_OMNI, SOBHANA_OMNI, BATAA_OMNI, YESUI_OMNI, YASMIN_OMNI, GRACE_OMNI, JOSEPH_OMNI, NILAR_OMNI, THIHA_OMNI, FINN_OMNI, ISELIN_OMNI, PERNILLE_OMNI, HEMKALA_OMNI, SAGAR_OMNI, ARNAUD_OMNI, DENA_OMNI, COLETTE_OMNI, MAARTEN_OMNI, OJAS_OMNI, AGNIESZKA_OMNI, MAREK_OMNI, ZOFIA_OMNI, GULNAWAZ_OMNI, LATIFA_OMNI, BLEUNOVA_OMNI, BLEUPEPPER_OMNI, BRENDA_OMNI, DONATO_OMNI, DOREREDWOOD_OMNI, ELZA_OMNI, FABIO_OMNI, FRANCISCA_OMNI, FUCSIACELTIC_OMNI, GIOVANNA_OMNI, HUMBERTO_OMNI, INDIGORUBIS_OMNI, IVORYNOCTURNE_OMNI, JULIO_OMNI, KURONILE_OMNI, LEILA_OMNI, MACERIO_OMNI, MANUELA_OMNI, NICOLAU_OMNI, OLIVAALBAHACA_OMNI, PLATACRESCENDO_OMNI, ROJOTREMOLO_OMNI, ROSEEBEURRE_OMNI, ROSEECASSIOPEIA_OMNI, THALITA_OMNI, VALERIO_OMNI, BLEUMARINEHEATWAVE_OMNI, BRUNPALLADIUM_OMNI, CREMAORATORIO_OMNI, FERNANDA_OMNI, ALINA_OMNI, EMIL_OMNI, DARIYA_OMNI, DMITRY_OMNI, SVETLANA_OMNI, SAMEERA_OMNI, THILINI_OMNI, LUKAS_OMNI, VIKTORIA_OMNI, PETRA_OMNI, ROK_OMNI, MUUSE_OMNI, UBAX_OMNI, ANILA_OMNI, ILIR_OMNI, NICHOLAS_OMNI, NICHOLASLATN_OMNI, SOPHIE_OMNI, HILLEVI_OMNI, MATTIAS_OMNI, SOFIE_OMNI, RAFIKI_OMNI, ZURI_OMNI, PALLAVI_OMNI, VALLUVAR_OMNI, MOHAN_OMNI, SHRUTI_OMNI, ACHARA_OMNI, NIWAT_OMNI, PREMWADEE_OMNI, AHMET_OMNI, EMEL_OMNI, OSTAP_OMNI, POLINA_OMNI, MADINA_OMNI, SARDOR_OMNI, HOAIMY_OMNI, NAMMINH_OMNI, AMBERROMARIN_OMNI, BLEUMARINECRISTAL_OMNI, CAFEPORTAMENTO_OMNI, CARAMELOTIBER_OMNI, GRAPHITEAURORA_OMNI, LILACRUBIS_OMNI, NAVYTORMENTA_OMNI, SAFIROSCHERZO_OMNI, SEPIAGIRASOL_OMNI, SILVERMARMARA_OMNI, XIAOCHEN_OMNI, XIAOHAN_OMNI, XIAOMENG_OMNI, XIAOMO_OMNI, XIAOROU_OMNI, XIAOYI_OMNI, XIAOYOU_OMNI, XIAOYUE_OMNI, YUNFAN_OMNI, YUNHAO_OMNI, YUNJIAN_OMNI, YUNJIE_OMNI, YUNQI_OMNI, YUNXIA_OMNI, YUNXIANG_OMNI, YUNXIAO_OMNI, YUNYANG_OMNI, YUNYI_OMNI, YUNZE_CUSTOMER_OMNI, HENAN_YUNDENG_OMNI, LIAONING_XIAOBEI_OMNI, SHAANXI_XIAONI_OMNI, SICHUAN_YUNXISICHUAN_OMNI, BLANCOFLORE_OMNI, GRISPIMIENTA_OMNI, HIUGAAI_OMNI, WANLUNG_OMNI, HSIAOCHEN_OMNI, HSIAOYU_OMNI, YUNJHE_OMNI, ADAM_HD, ALLOY_HD, ANDREW_HD, ANDREW2_HD, ANDREW3_HD, ARIA_HD, AVA_HD, AVA3_HD, BRIAN_HD, DAVIS_HD, EMMA_HD, EMMA2_HD, JENNY_HD, MULTITALKER_AVA_ANDREW_HD, NOVA_HD, PHOEBE_HD, SERENA_HD, STEFFAN_HD, TRISTAN_HD, XIMENA_HD, REMY_HD, VIVIENNE_HD, MASARU_HD, NANAMI_HD, XIAOCHEN_HD, YUNFAN_HD
voiceConfiguration	object	Von der gewählten Stimme unterstützte Parameter. null entfernt sie beim Agent-Update.
timezone	string	IANA-Zeitzone für zeitabhängiges Agent-Verhalten, etwa Europe/Berlin. Regeln: mindestens 1 Zeichen
greetingMorningText	string	Begrüßung am Morgen gemäß der Zeitzone des Agents.
greetingAfternoonText	string	Begrüßung am Nachmittag gemäß der Zeitzone des Agents.
greetingEveningText	string	Begrüßung am Abend gemäß der Zeitzone des Agents.
importantNote	string	Zusätzliche Anweisungen für den Agent. Regeln: null erlaubt
initialSilenceTimeoutMs	integer (int32)	Wie lange Azure auf den Beginn einer Äußerung wartet, in Millisekunden.
segmentationSilenceTimeoutMs	integer (int32)	Stille, nach der Azure erkannte Sprache in Abschnitte trennt, in Millisekunden.
phraseList	Liste von string	Wörter oder Ausdrücke als Erkennungshilfe, etwa Produktnamen. Als einzelne Listeneinträge senden, nicht als kommagetrennten Text.
greetingNonInterruptible	boolean	Verhindert, dass der Anrufer die Begrüßung unterbricht.
greetingTimeoutSeconds	integer (int32)	Zeitlimit für die Begrüßung, in Sekunden.
sttProvider	string	Spracherkennungsanbieter aus dem Agent-Katalog. Werte: AZURE, DEEPGRAM, KUGEL
deepgramEotThreshold	number	Konfidenz, ab der Deepgram den Gesprächsbeitrag als beendet einstuft.
deepgramEotTimeoutMs	integer (int32)	Deepgram-Zeitlimit für das Erkennen des Beitragsendes, in Millisekunden.
deepgramLanguageHints	Liste von string	Sprachhinweise aus dem Agent-Katalog. Sie gewichten die Deepgram-Erkennung, ohne die unterstützten Sprachen einzuschränken. Regeln: keine doppelten Einträge Alle 10 erlaubten Werte anzeigen de, en, es, fr, hi, it, ja, nl, pt, ru
preferPreProcessingGreeting	boolean	Verwendet die Begrüßung aus dem Pre Processing, sofern sie vorliegt.
ttsProvider	string	Sprachausgabeanbieter in der bisherigen Agent-Konfiguration. Regeln: null erlaubt Werte: AZURE, KUGEL
kugelVoiceId	integer (int32)	Stimmenkennung der bisherigen Kugel-Konfiguration. Regeln: ≥ 1; null erlaubt
kugelLanguages	Liste von string	Geordnete Kugel-Sprachcodes aus dem Agent-Katalog. Die erste Sprache wird zu Gesprächsbeginn erwartet. Beim Anlegen gilt standardmäßig Deutsch; Auslassen beim Update behält die Liste.
kugelTurnDetectionLevel	string	RESPONSIVE reagiert zügig; CONSERVATIVE wartet bei Denkpausen länger. Gilt für neue Anrufe; Auslassen beim Update behält die Einstellung. Werte: RESPONSIVE, CONSERVATIVE

voiceConfiguration — Felder

Feld	Typ	Beschreibung
temperature	number (double)	Sampling-Temperatur der Stimme. Niedrigere Werte erzeugen gleichmäßigere Sprache. Regeln: 0.3–1; null erlaubt
topP	number (double)	Top-p-Sampling-Einstellung, sofern von der Stimme unterstützt. Regeln: 0.3–1; null erlaubt
topK	integer (int32)	Top-k-Sampling-Einstellung, sofern von der Stimme unterstützt. Regeln: 1–50; null erlaubt
cfgScale	number (double)	Stärke der Stimmsteuerung, sofern die Stimme diesen Parameter unterstützt. Regeln: 1–2; null erlaubt
telecomEffectEnabled	boolean	Aktiviert Telefonklang für unterstützte Azure-HD-Stimmen. null verwendet den Plattformstandard.
enhancePronunciationEnabled	boolean	Aktiviert die Ausspracheverfeinerung für unterstützte Azure-HD-Stimmen. null verwendet den Plattformstandard.
xmlLang	string	Von der gewählten Stimme unterstützter Sprach- oder Akzentcode. Regeln: höchstens 10 Zeichen; null erlaubt Beispiel: "de-AT"
style	string	Von der gewählten Stimme unterstützter Sprechstil. Regeln: höchstens 50 Zeichen; null erlaubt

options — Felder

Feld	Typ	Beschreibung
model	string	Agent-Modell aus dem Agent-Katalog. Reasoning-, Temperatur- und Outputgrenzen des Eintrags beachten. Alle 19 erlaubten Werte anzeigen GPT_6_1_SOL, GPT_6_1_TERRA, GPT_6_SOL, GPT_6_LUNA, GPT_5_6_SOL, GPT_5_6_TERRA, GPT_5_6_LUNA, GPT_5, GPT_5_MINI, GPT_5_NANO, GPT_5_4, GPT_5_4_MINI, GPT_5_4_NANO, GPT_4_1, GPT_4_1_MINI, GPT_4_1_NANO, DEEPSEEK_V4_FLASH, MISTRAL_LARGE_3, MICROSOFT_DECISION_1
reasoningEffort	string	Vom gewählten Modell unterstützter Reasoning-Aufwand gemäß Agent-Katalog. Werte: NONE, MINIMAL, LOW
systemPrompt	string	Vollständige Agent-Anweisungen einschließlich Verhalten, Wissensgrenzen und Fehlerbehandlung. Regeln: mindestens 1 Zeichen
conversationHistoryLimit	integer (int32)	Maximale Anzahl der Gesprächsverlaufseinträge für das Modell.
knowledgeBaseId	string (uuid)	ID der zugeordneten Knowledge Base. null entfernt die Zuordnung.
ragTopK	integer (int32)	Maximale Anzahl abgerufener Wissensabschnitte pro Suche.
ragSimilarityThreshold	number (double)	Mindestähnlichkeit eines Wissensabschnitts, damit er berücksichtigt wird.
temperature	number (double)	Variation der Antworten. Eine feste Temperatur im Katalogeintrag des Modells beachten. Regeln: 0–2
maxTokens	integer (int32)	Maximales Output-Tokenbudget. Zusätzlich die Grenze des gewählten Modells im Katalog beachten. Regeln: 10–25000
ttsStreamingMode	string	Sprachausgabemodus aus dem Agent-Katalog. Werte: QUALITY_SSML, LOW_LATENCY_TEXT_STREAM
queryTransformEnabled	boolean	Formuliert Wissenssuchanfragen vor der Suche um. Auslassen oder null bedeutet false.
queryTransformHistoryLimit	integer (int32)	Maximale Anzahl der Gesprächsverlaufseinträge für die Suchumformulierung.
queryTransformPrompt	string	Prompt zur Suchumformulierung im LLM-Modus. DECISION verwendet decisionQueryTransform.
queryTransformConfidenceThreshold	number (double)	Erforderliche Konfidenz für die Suchumformulierung.
queryTransformMode	string	Verwendet eine LLM-Umformulierung oder einen separaten Suchentscheid mit Umformulierung. Werte: LLM, DECISION
decisionQueryTransform	object	Einstellungen für Suchentscheidung und Suchumformulierung. Die Funktion muss im Agent-Katalog verfügbar sein.

decisionQueryTransform — Felder

Feld	Typ	Beschreibung
rewriteModel	string	Modell zur Suchumformulierung. Im Katalog ein Modell mit supportsQueryRewrite=true wählen. Alle 19 erlaubten Werte anzeigen GPT_6_1_SOL, GPT_6_1_TERRA, GPT_6_SOL, GPT_6_LUNA, GPT_5_6_SOL, GPT_5_6_TERRA, GPT_5_6_LUNA, GPT_5, GPT_5_MINI, GPT_5_NANO, GPT_5_4, GPT_5_4_MINI, GPT_5_4_NANO, GPT_4_1, GPT_4_1_MINI, GPT_4_1_NANO, DEEPSEEK_V4_FLASH, MISTRAL_LARGE_3, MICROSOFT_DECISION_1
parallel	boolean	Führt Suchentscheidung und Suchumformulierung gleichzeitig aus.
decisionPrompt	string	Regeln für die Entscheidung, ob in der Knowledge Base gesucht wird: SEARCH oder SKIP.
rewritePrompt	string	Anweisungen zur Umformulierung der Wissenssuchanfrage.

{
  "agent": {
    "agentId": "00000000-0000-0000-0000-000000000001",
    "tenantId": "00000000-0000-0000-0000-000000000001",
    "enabled": false,
    "agentType": "VOICE",
    "title": "NuvoCar service",
    "description": "string",
    "agentName": "string",
    "persona": "string",
    "sttLanguages": [],
    "voice": "KLAUS_MAI_FLASH",
    "voiceConfiguration": {
      "temperature": 0.3,
      "topP": 0.3,
      "topK": 1,
      "cfgScale": 1,
      "telecomEffectEnabled": false,
      "enhancePronunciationEnabled": false,
      "xmlLang": "de-AT",
      "style": "string"
    },
    "timezone": "string",
    "greetingMorningText": "string",
    "greetingAfternoonText": "string",
    "greetingEveningText": "string",
    "importantNote": "string",
    "initialSilenceTimeoutMs": 0,
    "segmentationSilenceTimeoutMs": 0,
    "phraseList": [],
    "greetingNonInterruptible": false,
    "greetingTimeoutSeconds": 0,
    "sttProvider": "AZURE",
    "deepgramEotThreshold": 0,
    "deepgramEotTimeoutMs": 0,
    "deepgramLanguageHints": [],
    "preferPreProcessingGreeting": false,
    "ttsProvider": "AZURE",
    "kugelVoiceId": 1,
    "kugelLanguages": [],
    "kugelTurnDetectionLevel": "RESPONSIVE"
  },
  "options": {
    "model": "GPT_4_1_MINI",
    "reasoningEffort": "NONE",
    "systemPrompt": "string",
    "conversationHistoryLimit": 0,
    "knowledgeBaseId": "00000000-0000-0000-0000-000000000001",
    "ragTopK": 0,
    "ragSimilarityThreshold": 0,
    "temperature": 0,
    "maxTokens": 10,
    "ttsStreamingMode": "QUALITY_SSML",
    "queryTransformEnabled": false,
    "queryTransformHistoryLimit": 0,
    "queryTransformPrompt": "string",
    "queryTransformConfidenceThreshold": 0,
    "queryTransformMode": "LLM",
    "decisionQueryTransform": {
      "rewriteModel": "GPT_4_1_MINI",
      "parallel": false,
      "decisionPrompt": "string",
      "rewritePrompt": "string"
    }
  }
}

Fehlerantworten

Status	Bedeutung
400	Ungültige Eingabe, Auswahl oder Zeitgrenzen.
401	Fehlender, abgelaufener oder ungültiger Zugang. Der Body kann leer sein.
403	Benötigter Scope oder aktuelles Benutzerrecht fehlt. Der Body kann leer sein.
404	Ressource im gebundenen Workspace nicht verfügbar.
429	Gemeinsames Workspace-Budget überschritten. Retry-After abwarten; unklare Schreibvorgänge nicht blind wiederholen.
503	Vorübergehend nicht verfügbar. Unklare Schreibvorgänge vor erneutem Versuch prüfen.

Fehler-Body

Feld	Typ	Beschreibung
status	integer	HTTP-Statuscode.
error	string	Beschreibung des Fehlers.
details	any	Weitere Fehlerdetails, sofern vorhanden. Regeln: null erlaubt
code	string	Maschinenlesbarer Fehlercode.
params	object	Zusätzliche Werte zum Fehlercode.
fieldErrors	object	Validierungsfehler nach Eingabefeld.

Bei 429 oder 503 den Header Retry-After (Sekunden) beachten. Unklare Schreibvorgänge vor einem neuen Versuch prüfen.