Previsualizar configuración fusionada

GET

/v1/convai/agents/:agent_id/branches/:source_branch_id/merge-preview

GET

/v1/convai/agents/:agent_id/branches/:source_branch_id/merge-preview

curl -G https://api.elevenlabs.io/v1/convai/agents/agent_3701k3ttaq12ewp8b7qv5rfyszkz/branches/agtbrch_8901k4t9z5defmb8vh3e9361y7nj/merge-preview \
     -d target_branch_id=agtbrch_8901k4t9z5defmb8vh3e9361y7nj

{
  "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": {}
  }
}

Devuelve el resultado de fusionar la rama de origen en la rama de destino sin realizar la fusión. Es útil para mostrar un diff preciso antes de confirmar.

Parámetros de ruta

agent_idstringRequerido

El ID de un agente. Se devuelve al crear el agente.

source_branch_idstringRequerido

Identificador único de la rama de origen desde la que se fusionará.

Parámetros de consulta

target_branch_idstringRequerido

El ID de la rama de destino en la que se realizará la fusión.

forcebooleanOpcionalValor predeterminado: false

Cuando es true, los cambios de la rama de origen siempre prevalecen en los conflictos, independientemente de las marcas de tiempo.

Respuesta

Respuesta correcta.

agent_idstring

El ID del agente

namestring

El nombre del agente

conversation_configobject

La configuración de conversación del agente

metadataobject

Los metadatos del agente

platform_settingsobjectOpcional

La configuración de la plataforma del agente

phone_numberslist of objectsOpcional

Los números de teléfono del agente

whatsapp_accountslist of objectsOpcional

Cuentas de WhatsApp asignadas al agente

workflowobjectOpcional

El workflow del agente

access_infoobject or nullOpcional

La información de acceso del agente para el usuario.

tagslist of stringsOpcional

Etiquetas del agente usadas para categorizarlo

version_idstring or nullOpcional

El ID de la versión en la que se encuentra el agente

branch_idstring or nullOpcional

El ID de la rama en la que está el agente

main_branch_idstring or nullOpcional

El ID de la rama principal de este agente

proceduresmap from strings to objectsOpcional

Procedimientos indexados por procedure_id.

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

URL del tono de espera predeterminado que se reproduce a quienes llaman en cola cuando no se ha subido un audio de espera personalizado, para que el panel pueda previsualizarlo.

overridden_fieldslist of stringsOpcional

Rutas por puntos de los campos de configuración en los que ambas ramas modificaron el mismo campo con respecto a su antecesor común (conflictos). Están presentes independientemente de qué lado resuelva el conflicto.

conflictslist of objectsOpcional

Vista estructurada de los mismos conflictos que overridden_fields; cada uno incluye el valor de la base (antepasado común), la rama de origen y la rama de destino para poder mostrar y resolver la divergencia campo por campo.

source_identical_to_targetbooleanOpcionalValor predeterminado: false

True cuando la fusión o rebase no tendría efecto; es decir, cuando el resultado combinado es idéntico a la punta de la rama de origen. La ruta de API de rebase rechaza este caso.

Errores

422

Unprocessable Entity Error

Parámetros de ruta

Encabezados

Parámetros de consulta

Respuesta

Errores