Frequently Asked Questions (FAQs) and Troubleshooting

Installation

How do I configure Agent Factory with a 26ai Database?

Follow the steps in the setup guide to connect Agent Factory to Oracle AI Database 26ai. See

My company has an existing OCI account but I am not an administrator.

When signing up for a Free Tier account, by default your account is in the Administrators group. However, if your company has an existing OCI account and you are not in the Administrators group, ask your administrator to assign you with the following policy:

allow group <your-group-name> to manage generative-ai-family in compartment <your-compartment>

For more information see Getting access to generative AI.

What if I receive a message like ‘no space available on device’ during installation?

This error can occur due to low space in the /tmp directory.

• Run below command

  mkdir /scratch/podman_tmp
  

• Edit your ~/.config/containers/containers.conf pointing podman to a TMPDIR with enough free space. For example if your /scratch directory has enough memory (~100GB), then create the directory /scratch/podman_tmp and change contents of ~/.config/containers/containers.conf to:

  [engine]
  env = ["TMPDIR=/scratch/podman_tmp"]
  

What if I receive an error (proxyconnect tcp: tls: first record does not look like a TLS handshake) when doing podman login container-registry.oracle.com?

Update your proxy configuration so that it uses an http URL instead of https.

For example:

export https_proxy=http://www-proxy.us.oracle.com:80

After updating the proxy settings, try running the Podman login command again:

podman login container-registry.oracle.com

What are the space and RAM requirements?

MCP Server

I see “Authentication required” error

Set authType to Bearer or Basic and supply valid credentials. For OAuth, ensure server URL points to the /mcp endpoint and the token is not expired.

I see 404 error

The serverUrl’s path is likely wrong. Use the correct MCP endpoint path such as /mcp, /mcp/jsonrpc, or your server’s documented route.

Can we attach more than one MCP server to a single agent? How does the agent determine which MCP server to call and which tool to execute?

Yes, you can attach multiple MCP Servers to a single Agent. The LLM will select the appropriate server and tool based on each tool’s description and how well it matches the user’s query. Even when multiple tools are available, the model chooses the most relevant tool for the request.

Does MCP server support streamable HTTP?

Yes. StreamableHTTPTransport with auth is supported and recommended for OAuth/Bearer-secured servers.

Custom Agents

Is the custom agent conversational or stateless?

LLMs in Agent builder support conversational memory. Knowledge Agents are currently stateless, meaning they respond to one question at a time.

Can we connect sub-agents to an Agent?

Yes, you can attach multiple sub-agents to a single agent. The master agent orchestrates and coordinates with the sub-agents, selects the correct sub-agent based on the user’s query, and aggregates the final response.

Can I provide a custom knowledge base when building a custom agent?

Yes, you can provide custom knowledge bases when building a Knowledge Agent. Knowledge bases can be created using web sources, file systems, or SharePoint.