1. How do I use AI Agent Studio?
  2. How do I fix an external service, tool, or retrieval node that fails?

How do I fix an external service, tool, or retrieval node that fails?

Missing configuration, invalid parameters, service side errors, empty retrieval results, or mismatched authentication or context can all cause this failure. Use these steps to verify the configuration and isolate the cause of the failure.

  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 node configuration and confirm the selected tool, endpoint, index, or workflow is correct.
  6. Inspect the runtime input payload to verify the node is receiving the expected data.
  7. Review the returned status, error, and metadata fields for clues about the failure.
  8. If the input is wrong, trace the issue back to the payload-generation or mapping node.
  9. If the input is correct but the result is still wrong, investigate the configured service, data source, or selected tool.
  10. Pin a known good response only when you're isolating downstream behavior.