What should I do if the output from one node doesn't match the input expected by the next node?

A mismatch between the data returned by the upstream node and the format expected by the downstream node usually causes this behavior. For example, the data may be returned as a string, array, object, or different field structure.

Use the following steps to troubleshoot the problem:
  1. Go to AI Agent Studio and open the Workflows workflows tab.
  2. Select Edit Edit to modify a workflow.
  3. From the toolbar, select Debug Debug.
  4. Enter a prompt in Ask Oracle and submit it to run the workflow.
  5. Inspect the upstream node output to understand the data being produced.
  6. Inspect the downstream node input to see what data it expects.
  7. Compare the required fields, data types, and nesting between the two nodes.
  8. Use output editing to test the expected data shape without changing the upstream node.
  9. Adjust the upstream prompt, code, return value, or field mapping so the output matches the downstream node's expected format.
  10. Retest the workflow using the affected run profile to verify the issue has been resolved.