Agent aktualisieren

PATCH

/v1/convai/agents/:agent_id

PATCH

/v1/convai/agents/:agent_id

curl -X PATCH "https://api.elevenlabs.io/v1/convai/agents/agent_3701k3ttaq12ewp8b7qv5rfyszkz?branch_id=agtbranch_0901k4aafjxxfxt93gd841r7tv5t" \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "agent_id": "agent_7101k5zvyjhmfg983brhmhkd98n6",
  "name": "My Agent",
  "conversation_config": {
    "asr": {
      "quality": "high",
      "provider": "scribe_realtime",
      "user_input_audio_format": "pcm_16000",
      "keywords": [
        "hello",
        "world"
      ]
    },
    "turn": {
      "turn_timeout": 7,
      "silence_end_call_timeout": -1,
      "turn_eagerness": "normal",
      "spelling_patience": "auto",
      "speculative_turn": false,
      "retranscribe_on_turn_timeout": false,
      "turn_model": "turn_v3",
      "interruption_ignore_terms": [],
      "interruption_ignore_term_languages": [],
      "merge_with_default_ignore_terms": false,
      "transcribe_on_disabled_interruptions": false,
      "soft_timeout_config": {
        "timeout_seconds": -1,
        "message": "Hhmmmm...yeah."
      },
      "mode": "turn"
    },
    "tts": {
      "model_id": "eleven_turbo_v2",
      "voice_id": "cjVigY5qzO86Huf0OWal",
      "agent_output_audio_format": "pcm_16000",
      "stability": 0.5,
      "speed": 1,
      "similarity_boost": 0.8,
      "pronunciation_dictionary_locators": [],
      "optimize_streaming_latency": 3
    },
    "conversation": {
      "max_duration_seconds": 600,
      "client_events": [
        "audio",
        "interruption"
      ]
    },
    "language_presets": {},
    "vad": {
      "background_voice_detection": false
    },
    "agent": {
      "first_message": "Hello, how can I help you today?",
      "language": "en",
      "disable_first_message_interruptions": false
    }
  },
  "metadata": {
    "created_at_unix_secs": 1,
    "updated_at_unix_secs": 1
  },
  "workflow": {
    "edges": {
      "entry_to_tool_a": {
        "source": "entry_node",
        "target": "tool_node_a",
        "forward_condition": {
          "type": "llm",
          "condition": "Tool A condition"
        }
      },
      "start_to_entry": {
        "source": "start_node",
        "target": "entry_node",
        "forward_condition": {
          "type": "unconditional"
        }
      },
      "tool_a_to_failure": {
        "source": "tool_node_a",
        "target": "failure_node",
        "forward_condition": {
          "type": "result",
          "successful": false
        }
      },
      "tool_a_to_tool_b": {
        "source": "tool_node_a",
        "target": "tool_node_b",
        "forward_condition": {
          "type": "result",
          "successful": true
        }
      },
      "tool_b_to_agent_transfer": {
        "source": "tool_node_b",
        "target": "success_transfer",
        "forward_condition": {
          "type": "unconditional"
        }
      },
      "tool_b_to_conversation": {
        "source": "tool_node_b",
        "target": "success_conversation",
        "forward_condition": {
          "type": "llm",
          "condition": "Conversation condition"
        }
      },
      "tool_b_to_end": {
        "source": "tool_node_b",
        "target": "success_end",
        "forward_condition": {
          "type": "llm",
          "condition": "End condition"
        }
      },
      "tool_b_to_phone": {
        "source": "tool_node_b",
        "target": "success_phone",
        "forward_condition": {
          "type": "expression",
          "expression": {
            "type": "or_operator",
            "children": [
              {
                "type": "dynamic_variable",
                "name": "force_phone_transfer"
              },
              {
                "type": "llm",
                "value_schema": {
                  "type": "boolean",
                  "description": "Phone condition"
                },
                "prompt": "Phone condition"
              },
              {
                "type": "eq_operator",
                "left": {
                  "type": "dynamic_variable",
                  "name": "mode"
                },
                "right": {
                  "type": "string_literal",
                  "value": "dev"
                }
              }
            ]
          }
        }
      }
    },
    "nodes": {
      "entry_node": {
        "type": "override_agent",
        "additional_knowledge_base": [],
        "additional_prompt": "",
        "additional_tool_ids": [],
        "conversation_config": {},
        "edge_order": [
          "entry_to_tool_a"
        ],
        "entry_behavior": "auto",
        "label": "Entry",
        "position": {
          "x": 0,
          "y": 0
        }
      },
      "failure_node": {
        "type": "override_agent",
        "additional_knowledge_base": [],
        "additional_prompt": "",
        "additional_tool_ids": [],
        "conversation_config": {},
        "edge_order": [],
        "entry_behavior": "auto",
        "label": "Failure",
        "position": {
          "x": 0,
          "y": 0
        }
      },
      "start_node": {
        "type": "start",
        "edge_order": [
          "start_to_entry"
        ],
        "position": {
          "x": 0,
          "y": 0
        }
      },
      "success_conversation": {
        "type": "override_agent",
        "additional_knowledge_base": [],
        "additional_prompt": "",
        "additional_tool_ids": [],
        "conversation_config": {},
        "edge_order": [],
        "entry_behavior": "auto",
        "label": "Success A",
        "position": {
          "x": 0,
          "y": 0
        }
      },
      "success_end": {
        "type": "end",
        "edge_order": [],
        "position": {
          "x": 0,
          "y": 0
        },
        "return_when_nested": true
      },
      "success_phone": {
        "type": "phone_number",
        "custom_sip_headers": [],
        "edge_order": [],
        "position": {
          "x": 0,
          "y": 0
        },
        "sip_refer_play_dialtone": true,
        "transfer_destination": {
          "type": "phone",
          "phone_number": "+1234567890"
        },
        "transfer_type": "conference",
        "require_acceptance": false
      },
      "success_transfer": {
        "type": "standalone_agent",
        "agent_id": "success_transfer_agent",
        "delay_ms": 0,
        "edge_order": [],
        "enable_transferred_agent_first_message": false,
        "position": {
          "x": 0,
          "y": 0
        },
        "preserve_client_tts_overrides": false,
        "drop_history": false,
        "isolate_history": false
      },
      "tool_node_a": {
        "type": "tool",
        "edge_order": [
          "tool_a_to_failure",
          "tool_a_to_tool_b"
        ],
        "position": {
          "x": 0,
          "y": 0
        },
        "tools": [
          {
            "tool_id": "tool_a"
          },
          {
            "tool_id": "tool_b"
          }
        ]
      },
      "tool_node_b": {
        "type": "tool",
        "edge_order": [
          "tool_b_to_conversation",
          "tool_b_to_end",
          "tool_b_to_phone",
          "tool_b_to_agent_transfer"
        ],
        "position": {
          "x": 0,
          "y": 0
        },
        "tools": [
          {
            "tool_id": "tool_a"
          }
        ]
      }
    },
    "prevent_subagent_loops": false,
    "subgraphs": {}
  }
}

Aktualisiert die Einstellungen eines Agenten

Pfadparameter

agent_idstringErforderlich

Die ID eines Agenten. Sie wird beim Erstellen des Agenten zurückgegeben.

Abfrageparameter

enable_versioning_if_not_enabledbooleanOptionalStandardwert ist trueDeprecated

Veraltet: Alle Agenten sind versioniert. Dieser Parameter wird ignoriert.

branch_idstring or nullOptional

Die ID des zu verwendenden Branches

Anfrage

This endpoint expects an object.

conversation_configobjectOptional

Gesprächskonfiguration für einen Agenten

platform_settingsobjectOptional

Plattformeinstellungen für den Agenten umfassen alle Einstellungen, die nicht die Orchestrierung und Inhalte der Unterhaltung betreffen.

workflowobjectOptional

Workflow für den Agenten. Definiert den Ablauf des Gesprächs und wie der Agent mit Tools interagiert.

namestring or nullOptional

Ein Name, um den Agenten leichter zu finden

tagslist of strings or nullOptional

Tags zum Klassifizieren und Filtern des Agents

version_descriptionstring or nullOptional

Beschreibung dieser Version beim Veröffentlichen von Änderungen (gilt nur für versionierte Agents)

proceduresmap from strings to objects or nullOptional

Zu veröffentlichende Prozedurversionen, geschlüsselt nach procedure_id. Wenn angegeben, ersetzt diese Zuordnung die Prozeduren aus dem aktuellen Entwurf oder Branch-Tipp. Wenn ausgelassen oder null, werden unveröffentlichte Prozeduränderungen verwendet, falls vorhanden; andernfalls bleiben die Prozeduren des Branch-Tipps erhalten. Übergeben Sie ein leeres Objekt, um alle Prozeduren zu entfernen.

Antwort

Erfolgreiche Antwort

agent_idstring

Die ID des Agenten

namestring

Der Name des Agenten

conversation_configobject

Die Konfiguration der Unterhaltung des Agenten

metadataobject

Die Metadaten des Agenten

platform_settingsobjectOptional

Die Plattformeinstellungen des Agenten

phone_numberslist of objectsOptional

Die Telefonnummern des Agenten

whatsapp_accountslist of objectsOptional

Dem Agenten zugewiesene WhatsApp-Konten

workflowobjectOptional

Der Workflow des Agenten

access_infoobject or nullOptional

Die Zugriffsinformationen des Agents für den Nutzer

tagslist of stringsOptional

Tags zur Kategorisierung des Agenten

version_idstring or nullOptional

Die ID der Version, auf der sich der Agent befindet

branch_idstring or nullOptional

Die ID des Branches, auf dem sich der Agent befindet

main_branch_idstring or nullOptional

Die ID des Haupt-Branches für diesen Agenten

proceduresmap from strings to objectsOptional

Prozeduren, geschlüsselt nach procedure_id.

default_hold_audio_urlstringOptionalStandardwert ist https://eleven-public-cdn-common.elevenlabs.io/convai/ambient-audio-assets/elevator1.mp3

URL des standardmäßigen Wartetons, der Anrufern in der Warteschlange abgespielt wird, wenn kein benutzerdefiniertes Warteton-Audio hochgeladen wurde, damit das Dashboard ihn in der Vorschau anzeigen kann.

Fehler

422

Unprocessable Entity Error

Pfadparameter

Header

Abfrageparameter

Anfrage

Antwort

Fehler