eCG Agents

Connect eCG Agents

Give eComGear permission to reach your eCG Agents workspace by signing in at eCG Agents. See what you approve, how to check it, reconnect and disconnect.

If you have a workspace at eCG Agents, you can connect it to eComGear. You sign in at eCG Agents and approve what eComGear may reach. You do not copy or paste any key.

The connection is a permission, nothing more. It does not build a dashboard or a project by itself, and you can remove it at any time.

Before you start

  • You need an account at eCG Agents with a workspace of its own.
  • You need to be signed in to eComGear.
  • The connection belongs to you, not to your eComGear workspace. Your teammates do not see it, and each person connects on their own.

Connect

  1. In the left sidebar, under Platform, select Agents.
  2. Find the panel titled eCG Agents, below the eCG Dev Agent card. It shows Not connected.
  3. Select Sign in with eCG Agents. The panel says: "Approve what eComGear can reach. No key to copy, and you can disconnect any time."
  4. You are taken to eCG Agents. Sign in there if you are asked to, and read what eComGear is asking to reach.
  5. Approve it.
  6. You return to eComGear. A message says Connected to eCG Agents, and the panel now shows Connected.

If something stops the connection from finishing, you see: "Could not finish connecting. Please try again." Select Sign in with eCG Agents once more. If it fails again, contact support.

If the button is missing and the panel says that connecting is not set up, the connection is not switched on for your account yet. Contact support. See Get help.

Read your connections

Once connected, the panel text reads: "eComGear can reach the parts of your eCG Agents workspace listed below. Disconnect any time."

Each connection is one row.

On the row What it means
The workspace name The eCG Agents workspace you connected. If it has no name, the row says Workspace.
Small grey labels What you approved eComGear to reach. They come from eCG Agents and cannot be changed here. To approve a different set, disconnect and connect again.
An amber word next to the name, such as needs_reconnect The connection no longer works. See the table below.
Disconnect Removes the connection.

States of a connection

State What you see What to do
Working The workspace name with no extra word Nothing
Needs a new sign-in The amber word needs_reconnect beside the name Select Connect another and approve again for the same workspace. The connection works again and the old one is replaced. eCG Agents ends a connection when you or an admin there remove the permission.
Not connected The panel shows Not connected Select Sign in with eCG Agents

eComGear renews the permission by itself in the background, so you do not need to sign in again every day.

Connect another workspace

Select Connect another. Sign in and approve at eCG Agents, choosing the other workspace. Each workspace you connect gets its own row. Connecting the same workspace again does not make a second row. It refreshes the one you have.

Disconnect

  1. On the row you want to remove, select Disconnect.
  2. A message says Disconnected and the row disappears.

Disconnecting does two things. eComGear tells eCG Agents to end the permission, and eComGear forgets it. Dashboards you already built with this connection lose access to eCG Agents when their current permission runs out, which is soon after.

You do not lose your eCG Agents account or anything stored there. Only the link between the two products is removed.

What it is used for

A connection lets eComGear read your eCG Agents workspace on your behalf. Dashboards built for that workspace use it to show your agents' work. To change how such a dashboard looks, see Customize a connected dashboard.

To build your own app on eComGear, you do not need a connection. See The eCG Dev agent.

More agents are planned. When they are ready to use, they will show up on the Agents page.

Keep it safe

  • Approve only the workspaces you own or are allowed to manage.
  • If you leave a company or share a computer, select Disconnect first.
  • Do not share your screen while the approval page is open.
  • eComGear never shows you or asks you for an eCG Agents password. You sign in on the eCG Agents site itself.

If you see something unexpected

What you see What to do
The button says Connect another but you think you never connected Look at the rows. A teammate cannot connect for you, so a row means you connected earlier, possibly from another device. Disconnect it if you do not need it.
The workspace name is wrong Disconnect, then connect again and choose the correct workspace at eCG Agents.
The rows list is empty after you approved Refresh the page. If the panel still shows Not connected, try again.