Sign in to websites for an agent
Sign in to a website in the Browser window on the workspace computer, or add a sign-in for an agent securely from chat.
An agent's browser is the Browser window on its workspace computer. You can sign in to a website there yourself, or an admin can add a sign-in for the agent from chat. Sign-ins stay with the computer.
Before you start
- The agent's conversation must show Computer. An agent without a workspace computer has no browser.
- To add a sign-in from chat, you must be a workspace Owner or Admin.
- Workspace owners and admins set which websites the computer can reach. See Workspace computer Internet access.
Anyone who can use the computer can ask the agent to act through its signed-in accounts. Sign in only with accounts that are safe to share with those people. Websites can contain prompt injection, so allow only the websites that the agent needs.
Sign in on the computer
- Open a conversation with the agent.
- Select Computer. The desktop opens beside the conversation.
- Select Take control.
- In the Browser window, go to the sign-in page.
- Sign in on the page.
- Select Stop to end your control, then ask the agent to continue its task.
The browser normally keeps its sign-ins after the desktop stops and starts again. A website can still end its own session.
Add a sign-in from chat
When the agent needs an existing account that has no linked sign-in, it shows Sign-in needed in chat:
- Check the website and project shown on the card. Approved agents in that project can use the sign-in on that website.
- Select Add sign-in.
- Enter the username or email and password, or select Saved credentials to choose credentials you already manage. Do not paste passwords into a chat message.
- Leave Allow sign-in set to Until revoked, or choose Until a date.
- Select Save and continue for new credentials, or Link and continue for saved credentials.
The card saves credentials without posting entered values as chat messages. Sign-in tool results do not return credential values. The agent continues its task after setup. Select Decline if you do not want to share a sign-in. If setup succeeds but the task has not continued, select Continue task. If the request expires, ask the agent to request it again.
When the agent already has a linked sign-in for the website, it can use it without asking you again. If you ask it to create a new account, it can generate and save credentials for that task. A website may require additional verification before the account can be used.
If the agent says that it cannot fill linked credentials on this computer, sign in yourself on the computer as described above.
Open Agent settings → Secrets & variables to inspect the sign-in links and their permitted website. Manage or revoke saved credentials in Settings → Secrets & variables, with the workspace selected under Settings scope. Revoking a credential stops the agent from using it again.
Open a website with HTTP authentication
Some websites request a username and password before they show any page. For these websites, an administrator links both credentials to the agent's project and the exact HTTPS website origin in Secrets & variables. Keep credential values out of chat.
Ask the agent to use those linked credentials for HTTP authentication. The agent uses the link names and does not receive the values. A credential linked to one website cannot authenticate another origin, including a different scheme or port.
If something goes wrong
- The conversation does not show Computer: the agent has no browser. Ask the agent in a conversation that shows Computer.
- The website is blocked: the workspace Internet policy does not allow it. The agent can ask in chat to allow the website. See Workspace computer Internet access.
- The website signs you out: ask the agent to sign in again with its linked credentials, or sign in yourself on the computer.
For more checks, see Troubleshooting.