Nobody can see the agent
Usual cause
No roles added in the agent team's Security tab, or it isn't published
Fix
Add the roles and publish

ORACLE AI AGENT STUDIO · TROUBLESHOOTING
Type what you're seeing, for example "agent not showing", to find the fix.
Usual cause
No roles added in the agent team's Security tab, or it isn't published
Fix
Add the roles and publish
Usual cause
Permission groups aren't enabled on that role
Fix
Edit the role and select Enable Permission Groups
Usual cause
Missing runtime duty role
Fix
ORA_DR_FAI_GENERATIVE_AI_AGENT_RUNTIME_DUTY
Usual cause
The document isn't Published, or it wasn't republished after moving environments
Fix
Publish or republish it
Usual cause
The email tool needs reconfiguring in the new environment
Fix
Reconfigure it
Usual cause
Authentication wasn't re-entered after moving
Fix
Re-enter it
Usual cause
No Runtime File Processor tool
Fix
Add it
Usual cause
The usage process hasn't run, or the viewer lacks the monitoring permission group
Fix
Schedule Aggregate AI Agent Usage and Metrics; add read:Generative AI Workflow Execution
Usual cause
The team isn't published, or the role lacks the batch job duty
Fix
Publish it; add ORA_DR_FAI_BATCH_JOB_MANAGER_DUTY
Usual cause
Instructions are too loose, or the documents conflict
Fix
Tighten scope and sources; run the document health check
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.
Usual cause
Missing permission groups or security sync.
Fix
Add the permission groups with the AllRowsAllFields view and run the security sync processes (Oracle Support KB863374).
Usual cause
It's a predefined role.
Fix
Use a custom role, such as a copy of Employee.
Usual cause
No access to its product family.
Fix
Add access for that product family.
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.
Usual cause
Its index hasn't run.
Fix
Schedule Index AI Agent Studio Assistant Objects and Attributes daily.
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.
Usual cause
Structured parsing before the 26B bundle of 29 May 2026.
Fix
Update, or split and simplify the file.
Usual cause
They can open the application but not one of its workflows.
Fix
Give their role access to every workflow in the application.
Usual cause
They lack the monitoring permission group.
Fix
Add read:Generative AI Workflow Execution with AllRowsRestrictedFields.
ORA_PER_AGENT_TASK_TYPE_GUIDED_JOURNEYS_ENABLED is set to Y. It's N by default.HRC_ACCESS_AI_AGENT_CHAT_PRIV) and the runtime duty role (ORA_DR_FAI_GENERATIVE_AI_AGENT_RUNTIME_DUTY).Still stuck? Note the time and the trace from Monitoring and Evaluation before raising a service request with Oracle Support.