Create a new Conversation Flow that can be attached to an agent for response generation. Requires start_speaker, model_choice, and nodes. Returns conversation_flow_id and full configuration.
mcpsarrayMCP (Model Context Protocol) server configurations. Enables integration with external MCP-compatible services. Each MCP may include 'name', 'url', 'headers', 'query_params', and 'timeout_ms'.
nodesRequiredarrayArray of conversation flow nodes. Each node must have an 'id' (string), 'type' (string), and type-specific configuration like 'instruction'. Example: [{'id': 'greeting_node', 'type': 'conversation', 'instruction': {'type': 'prompt', 'text': 'Greet the user'}}].
toolsarrayCustom and built-in function definitions available in the conversation flow. Includes custom tools, end call tools, appointment booking tools, etc.
kb_configobjectKnowledge base configuration for retrieval behavior. May include 'top_k' and 'filter_score' parameters.
componentsarrayReusable sub-flows embedded within the conversation flow. Each component has its own nodes and tools.
model_choiceRequiredobjectModel configuration with model name and type. Example: {'model': 'gpt-4o', 'type': 'cascading'}. Required fields: 'model' (string) and 'type' (string).
global_promptstringSystem instructions applied across all nodes in the conversation flow. Used to define overall agent behavior and personality.
start_node_idstringID of the node where execution begins. If not specified, the first node in the nodes array is used.
start_speakerRequiredstringWho initiates the conversation. Either 'user' or 'agent'.
is_transfer_llmbooleanWhether this conversation flow is used for transfer LLM scenarios. Affects how the flow is processed during call transfers.
model_temperaturenumberControls the randomness of the model's responses. Valid range: 0-1. Lower values make responses more deterministic. Default: 0.7.
knowledge_base_idsarrayArray of knowledge base IDs for RAG (Retrieval-Augmented Generation). Enables the agent to retrieve information from specified knowledge bases.
dataRequiredData from the action execution
errorstringError if any occurred during the execution of the action
successfulRequiredbooleanWhether or not the action execution was successful or not
API key connection. Risk level 2 of 5.
Free Action
No published Skills explicitly reference this Action yet.