Skip to main content

Troubleshoot cloud agents

This page lists the limits of cloud agents and the messages that the Fluence Console shows when something goes wrong, with what to do about each.

Limits​

WhatLimit
Agent name128 bytes, on one line
Task and each message20,000 characters
RepositoryOne per agent, required, an https:// address without credentials
Time per turn6 hours for a turn launched from the console
Idle timeWhole hours, 1 or more, set in the preset. An empty field takes the default.
Agents alive at onceLimited per account. A launch over the limit is refused.
Preset name64 characters, unique among your presets
Secret name64 lowercase letters, digits, and underscores
Custom provider name48 lowercase letters, digits, and hyphens
Plugins in one preset100

For the limits of plugin variables, see Plugin order and limits.

The section does not open​

MessageWhat to do
Connecting Cloud agents…Wait. The console connects the section to your account by itself.
Could not connect Cloud agentsClick Retry.

The launch is closed or refused​

The line under Launch agent says why the button is disabled:

MessageWhat to do
Connect an AI provider to launch.Connect a provider on the AI providers page. See Connect an AI provider.
Add a GitHub token to launch.Add a token on the Secrets page. See Add the GitHub token.
Reload the page to launch.The console could not read your setup. Reload the page.

The form checks its fields when you click Launch agent:

MessageWhat to do
Describe the taskFill in Task
Choose a modelChoose a model in Model
Enter a repository URLFill in Repository URL. A launch needs a repository.
Enter an https:// repository URL without credentialsUse an address such as https://github.com/owner/repository. Do not put a user name or a token into the address. SSH addresses are not accepted.
Use a shorter name, Use a name without line breaksShorten the agent name, or remove line breaks from it
This form expired. Reload the page.Reload the page and launch again

A launch can also be refused after you click Launch agent. The console shows the reason:

ReasonWhat to do
A secret that an MCP server or a plugin names is missingAdd the secret on the Secrets page, or change the extension. The preset page marks it Missing secret.
The model is not availableChoose a model from the list, and check that its provider is connected.
The ChatGPT subscription is not activeOn the AI providers page, click Sign in again, or select another subscription
The limit of agents is reachedStop an agent that you no longer need, then launch again
The preset, its secrets, or its AI providers no longer existReload the page and choose another preset, or fix the preset on its page

The agent failed​

A failed agent shows the reason in the Details panel of its page.

MessageWhat it means and what to do
The agent's machine could not be created.Fluence could not create the machine. Launch again. If it repeats, choose another size or cluster in the preset.
The repository could not be prepared on the agent's machine.The agent could not clone the repository. Check the address and that the GitHub token has access to it, then launch again.
The agent's machine does not offer the model the agent was launched with.The model is not served by your providers. Launch again with a model from the list.
The AI profile's subscription sign-in no longer works. Sign in again.Sign in to ChatGPT again on the AI providers page, then launch again
The models of the AI profile's subscription could not be read.Check the subscription on the AI providers page, then launch again
The agent's machine is gone., The agent's machine could not be found., The agent's machine is being shut down.The machine ended under the agent. Launch a copy.
The agent's machine refused to start the agent., The agent could not be confirmed as started on its machine., The agent's session on its machine was lost.The agent did not start or was lost on the machine. Launch a copy.
The agent stopped because of an error.An error without a known reason. Launch a copy. If it repeats, contact support.

To launch again with the same settings, open the menu and click Launch a copy.

A turn went wrong​

A turn can go wrong while the agent itself stays alive. The agent becomes Idle and takes your next message. The conversation shows This turn failed., This turn was interrupted., or It is not known how this turn ended. The Last turn column of the agent list shows a short reason:

ReasonWhat it meansWhat to do
interruptedYou interrupted the turnSend the next message
turn_budget_exceededThe turn ran out of its time limitSend a message to continue. Split large work into smaller tasks.
turn_silence_exceededThe turn produced no output for too long and was stoppedSend a message to continue. If it repeats, try another model.
unknownThe reason could not be toldSend the message again
Another reasonAn error of the model or the provider, for example a rejected key, a rate limit, or an exhausted quotaCheck the key, the plan, and the limits at your AI provider. Then send the message again, or launch a new agent with another model.

An extension does not work​

SymptomWhat to check
The preset shows Missing secretThe extension names a secret that the preset does not have. Add it on the Secrets page under the same name.
Calls to an MCP server fail with an authorization errorThe header. Most servers take Authorization: Bearer <key>. Some take X-API-KEY: <key>. Also check that the secret value is the key alone, without Bearer.
The agent has no tools of an MCP serverThe URL of the endpoint, and that the server is reachable from the internet. Also check that the preset of the agent includes the server.
A change to an extension or a secret has no effectA running agent keeps what it started with. Stop it and launch a new one.
The console refuses a pluginThe package format, a reserved or repeated variable name, or two plugins that set one variable to different values. See OpenCode plugins.
The console refuses a secret nameThe name makes a reserved environment variable. See How secrets reach the agent.

Questions​

Can I launch an agent without a repository?​

No. A launch needs a repository, and the agent clones it with the GitHub token.

Can the agent open a pull request?​

Yes, if the GitHub token has write access to the repository. With read access only, the agent can clone and read, but it cannot push.

Can I see the value of a secret or a key that I saved?​

No. Fluence stores the value and never shows it again. Save a new value if you lost the old one.

Can I change the model, the machine, or the secrets of a running agent?​

No. An agent keeps what it was launched with. Stop it and launch a copy with the new settings.

Can I restart an ended agent?​

No. Ended and Failed are final. Click Launch a copy to start a new agent with the same task, model, and repository.

Can I rename or delete an agent?​

No. The name is set at launch. Ended and failed agents stay in the list and are hidden by default.

Why did my agent end by itself?​

It stayed idle for the idle time of its preset. To keep idle agents longer, raise Idle hours in the Machine block of the preset. A longer idle time means that you pay for the machine longer.

Do I pay while the agent is idle?​

Yes. You pay for the machine while it runs, also when the agent waits for a message. The machine is released when the agent stops or ends.

Does Fluence charge for the model?​

The machine price does not include model use. Your AI provider bills it under your key or your subscription.