Submit feedback for a Davis CoPilot recommender conversation in Dynatrace, including the message token, origin, feedback type, and response details.
| POST | SaaS | https://{your-environment-id}.apps.dynatrace.com/platform/davis/copilot/v1/skills/conversations:feedback |
Allows to provide feedback to a conversational recommender response. The payload is a JSON dictionary combining feedback and information from the conversational recommender response. Please review the examples for the correct payload formatting.
Parameters:
messageToken: Message token as provided by conversation:message.
origin: Application name of the caller.
feedback: Feedback dictionary.
userPrompt (Optional): Message prompt as sent to the conversation:message endpoint.
copilotResponse (Optional): Response as received from the conversation:message endpoint.
sources (Optional): List of sources as received from the conversation:message endpoint.
Please note, this endpoint is in preview and is subject to the Dynatrace preview conditions, as linked in the overview.
To execute this request, you need a platform token or OAuth access token with davis-copilot:conversations:execute scope. To learn how to obtain and use it, see Tokens and authentication.
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| body | Conversation | - | body | Required |
ConversationFeedbackRequest object| Element | Type | Description | Required |
|---|---|---|---|
| messageToken | string | - | Required |
| origin | string | - | Required |
| feedback | Conversation | - | Required |
| userPrompt | string | - | Optional |
| copilotResponse | string | - | Optional |
| sources | string[] | - | Optional |
ConversationFeedback object| Element | Type | Description | Required |
|---|---|---|---|
| type | Conversation | -The element can hold these values
| Required |
| text | string | - | Optional |
| category | Conversation | Must be one of [ "misunderstood", "incorrect", "incomplete", "error", "other" ] | Optional |
| improvement | Conversation | - | Optional |
ConversationFeedbackType objectConversationFeedbackCategory objectMust be one of [ "misunderstood", "incorrect", "incomplete", "error", "other" ]
ConversationImprovedSummary object| Element | Type | Description | Required |
|---|---|---|---|
| text | string | - | Required |
| confirmation | boolean | - | Required |
This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.
{"messageToken": "1e9eaca7-2a32-4263-806f-787fa2e1350c","origin": "Davis CoPilot app","feedback": {"type": "positive","text": "Exactly I was looking for."},"userPrompt": "How can I install the Dynatrace OneAgent?","copilotResponse": "To install the Dynatrace OneAgent, follow these steps: ...","sources": ["https://docs.dynatrace.com/docs/setup-and-configuration/dynatrace-oneagent/installation-and-operation/windows/installation/install-oneagent-on-windows","https://docs.dynatrace.com/docs/setup-and-configuration/dynatrace-oneagent/oneagent-troubleshooting/troubleshoot-oneagent-installation"]}
| Code | Type | Description |
|---|---|---|
| 202 | - | Feedback successfully submitted |
| 4XX | Client | - |
| 5XX | Internal | - |
ClientErrorResponse object| Element | Type | Description |
|---|---|---|
| error | Client | - |
ClientErrorResponseObject object| Element | Type | Description |
|---|---|---|
| code | integer | - |
| message | string | - |
{"error": {"code": 400,"message": "Bad Request"}}