Method
getDeploymentConversation GET
Copy GET

Gets a deployment conversation.

Arguments:

REQUIRED KEY TYPE DESCRIPTION
No deploymentConversationId str Unique ID of the conversation. One of deployment_conversation_id or external_session_id must be provided.
No externalSessionId str External session ID of the conversation.
No deploymentId str The deployment this conversation belongs to. This is required if not logged in.
No filterIntermediateConversationEvents bool If true, intermediate conversation events will be filtered out. Default is true.
No getUnusedDocumentUploads bool If true, unused document uploads will be returned. Default is false.
No start int The start index of the conversation.
No limit int The limit of the conversation.
No includeAllVersions bool If True, includes all versions of the last bot message for version switching functionality.
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.
ownerUserId str The user id of the owner of the deployment conversation.
ownerOrgId str The organization id of the owner of 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.
hasHistory bool Whether the deployment conversation has any history.
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.
chatllmTaskId str The chatllm task id associated with the deployment conversation.
conversationStatus str The status of the deployment conversation (used for deep agent conversations).
computerStatus str The status of the computer associated with the deployment conversation (used for deep agent conversations).
filesystemStatus str The status of the filesystem associated with the deployment conversation (used for deep agent conversations).
totalEvents int The total number of events in the deployment conversation.
contestNames List[str] Names of contests that this deployment is a part of.
daemonTaskId str The daemon task id associated with the deployment conversation.
parentDeploymentConversationId str The parent deployment conversation id associated with the deployment conversation.
introMessage str The intro message for the deployment conversation.
previewInfo dict App preview info.
latestContext dict dict containing a list of important segments for pagination in deepagent.
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.
computePointsUsed int The number of compute points used for the message.
computerFiles list The list of files that were created by the computer agent.
toolUseRequest dict The tool use request for the message.
verificationSummary str The summary of the verification process for the message.
attachedUserFileNames list The list of files attached by the user on the message.
oldFileContent str The content of the file associated with an edit tool request before the file was edited
allVersions list All versions of the last bot message for version switching functionality.
selectedVersionIndex int The index of the currently selected version of the last bot message.
totalVersions int The total number of versions available for the last bot message.
isLastMessage bool Whether this message is the last message in the conversation.
hostedArtifacts HostedArtifact Artifacts that have been deployed by this conversation.
KEY TYPE Description
hostname String The url at which the application is being hosted.
artifactType String The type of artifact being hosted.
llmArtifactId Unique String Identifier The artifact id being hosted.
lifecycle String The lifecycle of the artifact.
externalApplicationId Unique String Identifier Agent that deployed this application.
deploymentConversationId Unique String Identifier Conversation that created deployed this artifact, null if not applicable.
conversationSequenceNumber Number(Integer) Conversation event associated with this artifact, null if not applicable.

Exceptions:

TYPE WHEN
DataNotFoundError `deploymentConversationId` is not found.
DataNotFoundError `externalSessionId` is not found.
DataNotFoundError `deploymentId` is not found.
Language:

© Copyright