Method
createDeploymentConversation POST
Copy POST

Creates a deployment conversation.

Arguments:

REQUIRED KEY TYPE DESCRIPTION
No deploymentId str The deployment this conversation belongs to.
No name str The name of the conversation.
No externalApplicationId str The external application id associated with the deployment conversation.
Note: The arguments for the API methods follow camelCase but for Python SDK underscore_case is followed.

Response:

KEY TYPE DESCRIPTION
success Boolean true if the call succeeded, false if there was an error
result DeploymentConversation
KEY TYPE Description
deploymentConversationId str The unique identifier of the deployment conversation.
name str The name of the deployment conversation.
deploymentId str The deployment id associated with the deployment conversation.
createdAt str The timestamp at which the deployment conversation was created.
lastEventCreatedAt str The timestamp at which the most recent corresponding deployment conversation event was created at.
externalSessionId str The external session id associated with the deployment conversation.
regenerateAttempt int The sequence number of regeneration. Not regenerated if 0.
externalApplicationId str The external application id associated with the deployment conversation.
unusedDocumentUploadIds List[str] The list of unused document upload ids associated with the deployment conversation.
humanizeInstructions dict Instructions for humanizing the conversation.
conversationWarning str Extra text associated with the deployment conversation (to show it at the bottom of chatbot).
conversationType str The type of the conversation, which depicts the application it caters to.
metadata dict Additional backend information about the conversation.
llmDisplayName str The display name of the LLM model used to generate the most recent response. Only used for system-created bots.
llmBotIcon str The icon location of the LLM model used to generate the most recent response. Only used for system-created bots.
searchSuggestions List The list of search suggestions for the conversation.
history DeploymentConversationEvent The history of the deployment conversation.
KEY TYPE Description
role str The role of the message sender
text str The text of the message
timestamp str The timestamp at which the message was sent
messageIndex int The index of the message in the conversation
regenerateAttempt int The sequence number of regeneration. Not regenerated if 0.
modelVersion str The model instance id associated with the message.
searchResults dict The search results for the message.
isUseful bool Whether this message was marked as useful or not
feedback str The feedback provided for the message
feedbackType str The type of feedback provided for the message
docInfos list A list of information on the documents associated with the message
keywordArguments dict User message only. A dictionary of keyword arguments used to generate response.
inputParams dict User message only. A dictionary of input parameters used to generate response.
attachments list A list of attachments associated with the message.
responseVersion str The version of the response, used to differentiate w/ legacy agent response.
agentWorkflowNodeId str The workflow node id associated with the agent response.
nextAgentWorkflowNodeId str The id of the workflow node to be executed next.
chatType str The type of chat llm that was run for the message.
agentResponse dict Response from the agent. Only for conversation with agents.
error str The error message in case of an error.
segments list The segments of the message.
streamedData str Aggregated streamed messages from the agent.
streamedSectionData str Aggregated streamed section outputs from the agent in a list.
highlights dict Chunks with bounding boxes for highlighting the result sources.
llmDisplayName str The display name of the LLM model used to generate the response. Only used for system-created bots.
llmBotIcon str The icon location of the LLM model used to generate the response. Only used for system-created bots.
formResponse dict Contains form data response from the user when a Form Segment is given out by the bot.
routedLlm str The LLM that was chosen by RouteLLM to generate the response.

Exceptions:

TYPE WHEN
DataNotFoundError

deploymentId is not found.

DataNotFoundError

externalApplicationId is not found.

Language: