Log Explainer Agent

The Log Explainer Agent turns technical workflow error messages in DCKAP Integrator into clear, plain-language explanations. Instead of interpreting a raw error yourself, you get a readable summary of what went wrong and what to try next.

For each error, the agent gives you:

  • A plain-language explanation of the error
  • The possible root cause
  • The workflow step where the failure occurred, when available
  • Suggested next steps for troubleshooting

Current version: Log Explainer Agent v1.
No setup or consent is needed.

How to use Log Explainer

  1. Open the Logs page.
  2. Click View Detailed Logs for any failed workflow.
  3. Find a workflow-level error.
  4. Click the AI / Explain button next to the error.
  5. Review the AI-generated explanation.
  6. Use the suggested next steps to investigate the failure.

Example:

For the error 400 Bad Request – Invalid customer_id, the agent can explain that the request failed because the required customer identifier was invalid or missing. It also names the affected step, when available, and suggests how to investigate.

Scope and limitations (v1)

Log Explainer Agent v1 works with workflow-level errors on the Logs page. It analyzes the raw error message only, so explanation quality depends on how much the original message says.

In v1:

  • Only workflow-level errors are supported.
  • There is no additional workflow or execution context.
  • Detailed logs are not supported.
  • Console logs are not supported.
  • You can’t have a conversation or ask follow-up questions.

Future releases plan to add console logs and more workflow and execution context for fuller explanations.

Security and data privacy: Log Explainer does not require consent. It processes the error information available on the Logs page to generate the explanation.

Note: Log Explainer uses AI to interpret errors, so its root cause and suggestions are guidance only. For complex failures, support engineers may need to review the detailed logs and workflow configuration.

Troubleshooting

ProblemLikely causeWhat to do
No AI / Explain button next to an errorThe error isn’t a workflow-level errorOnly workflow-level errors are supported in v1
The explanation is vagueThe original error message has little detailCheck the workflow configuration, or contact the integrator support portal
No failed step is shownThe error message doesn’t identify the stepFind the failing step in the workflow yourself.
The root cause doesn’t matchThe agent sees only the raw error, not the workflow or executionValidate against the workflow and system configuration
You want to ask a follow-upConversations aren’t supported in v1