A woman in silhouette draws glowing lines between points of light on a tall glass panel, with a finished orb of light beside it.

ORACLE AI AGENT STUDIO · TROUBLESHOOTING

My agent can't see…

Type what you're seeing, for example "agent not showing", to find the fix.

A builder can open the Studio but can't try agents

Usual cause
Missing runtime duty role

Fix
ORA_DR_FAI_GENERATIVE_AI_AGENT_RUNTIME_DUTY

Document stuck at Ready to Publish

Usual cause
The publishing process didn't run or failed.

Fix
Check the permission oraCommonFusionAISecurityAuthorization_create_Rag_OraResource, set the document back to Draft, save, then set Ready to Publish again and save.

The standard Employee role isn't in the Security list

Usual cause
It's a predefined role.

Fix
Use a custom role, such as a copy of Employee.

Not answering in the user's language

Usual cause
The language option is off somewhere.

Fix
Switch on "Answer in user's language" in Chat Experience and on every LLM and agent node.

The builder assistant is unavailable

Usual cause
Its index hasn't run.

Fix
Schedule Index AI Agent Studio Assistant Objects and Attributes daily.

Answers are slow

Usual cause
Too many tokens, or too large a model.

Fix
Shorten prompts, pass less data between steps, set a response length and use a smaller model.

Part of an application doesn't work for some people

Usual cause
They can open the application but not one of its workflows.

Fix
Give their role access to every workflow in the application.

Monitoring shows nothing for some users

Usual cause
They lack the monitoring permission group.

Fix
Add read:Generative AI Workflow Execution with AllRowsRestrictedFields.

Agent not showing in a guided journey

  • The profile option ORA_PER_AGENT_TASK_TYPE_GUIDED_JOURNEYS_ENABLED is set to Y. It's N by default.
  • The guided journey has a task with the task type Agent, pointing to your published agent.
  • The journey is enabled on a Redwood page. Agent tasks don't appear on classic or responsive pages.
  • The person has the Intelligent Agent Chat privilege (HRC_ACCESS_AI_AGENT_CHAT_PRIV) and the runtime duty role (ORA_DR_FAI_GENERATIVE_AI_AGENT_RUNTIME_DUTY).
Stage 6: Access

Still stuck? Note the time and the trace from Monitoring and Evaluation before raising a service request with Oracle Support.