Troubleshooting

Startup Time

Problem: After starting the AI Optimizer, it takes a long time to load the first page.

Solution: This is normally the result of a configured database that is inaccessible. Depending on how you’ve configured the database, if retry_count, and retry_delay is set but the database is inaccessible, the AI Optimizer will appear to hang for the duration of retry_count * retry_delay during the startup.

Embedding Rate Limits

Problem: During embedding, especially when using trial keys, you may experience a failure due to rate limits. For example:

Operation Failed: Unexpected error: status_code: 429, body:  
data=None message='trial token rate limit exceeded, limit is 100000 tokens per minute'.

Solution: Set a rate limit based on the API Key restrictions.

Testbed Evaluation

Problem: During the Evaluation in the Testbed, a database error occurs: DPY-4011: the database or network closed the connection

Solution: Increase the memory of the vector_memory_size. If this is an Oracle Autonomous Database, scale up the CPU.

Autonomous Database behind VPN

Problem: Connection to an Autonomous database while inside a VPN fails.

Solution: Update the database connection string to include a https_proxy and https_proxy_port.

For example:

ADB_HIGH =
(DESCRIPTION = 
  (ADDRESS = 
    (PROTOCOL = tcps)(HOST = <adb_host>)(PORT = 1522)
    (HTTPS_PROXY = <proxy_host>)(HTTPS_PROXY_PORT = <proxy_port>)  # <-- Add
  )
  (CONNECT_DATA = 
    (SERVICE_NAME = <serviceName>)
    (SECURITY = 
      (ssl_server_dn_match=yes)
    )
  )
)

Client Fails to Load on Corporate Networks

Problem: The AI Optimizer Client fails to load in certain network environments. The browser console shows a JavaScript file (index.<hash>.js) blocked with NS_ERROR_CORRUPTED_CONNECTION (Firefox) or a similar connection error.

Solution: This is typically caused by a corporate firewall, deep packet inspection (DPI), or SSL inspection appliance corrupting the unencrypted HTTP traffic. Enable HTTPS on the client to encrypt the connection end-to-end. See TLS / HTTPS for configuration details.