Skip to content
AgentZforiMIS®

AgentZ app troubleshooting

Use this article when something in the AgentZ app itself does not work: the iMIS browser cannot open a page, AgentZ loses touch with iFINITY’s service, or a screen such as AgentZ Design, Website Migration or All activity reports an error. Each heading is what you see.

The iMIS browser shows We couldn’t open and your iMIS site’s address, a line saying why, Try again, and Technical details (closed). The line says what to check:

The line says Check the following
“The address couldn’t be found. Check your internet connection, or ask your iMIS administrator whether the site address has changed.” Your internet connection. Whether your iMIS site’s address has changed: compare it with Settings > iMIS, step 1 iMIS site.
“This computer is offline. Check your internet connection, then try again.” Your Wi-Fi or network cable, and your VPN if you use one.
“The site took too long to respond. It may be busy or down; try again in a moment.” Whether your iMIS site opens in your web browser. iMIS may be busy or down for maintenance.
“The connection to the site was interrupted. Try again.” Your network. Click Try again.
“The site’s security certificate couldn’t be checked, so AgentZ didn’t open it. Ask your iMIS administrator to check it.” Ask whoever looks after iMIS to check the site’s security certificate. AgentZ does not open the page until it can be checked.
“A proxy or firewall on your network blocked the connection. Ask your IT team to allow the iMIS site.” Ask your IT team to allow your iMIS site’s address through your organisation’s proxy or firewall.
“The site didn’t load. Try again; if it keeps happening, check with your iMIS administrator.” Click Try again. If it keeps happening, open Technical details and send what it says to whoever looks after iMIS.

Then click Try again.

“Try again. If it keeps happening, restart AgentZ.”

Click Try again. If the message comes back, quit AgentZ completely and open it again. If it still comes back, see Contacting iFINITY support, and include what Technical details says.

Your AgentZ licence isn’t linked to an iMIS site yet

Section titled “Your AgentZ licence isn’t linked to an iMIS site yet”

“AgentZ needs your organisation’s iMIS address before it can open iMIS.”

Your organisation’s licence does not have your iMIS site’s address yet. Ask your Organisation admin, or email helpdesk@ifinity.co.uk. When it has been added, click Check again. Settings > Overview shows the same as Not linked yet on the iMIS site check.

The pill at the top right of the window pulses amber and reads Reconnecting to the AgentZ service, and Settings > Overview shows “Reconnecting to the AgentZ service.” on the Licence check.

AgentZ cannot reach iFINITY’s service right now and keeps trying by itself. You stay signed in.

Check the following:

  • Your internet connection, and your VPN if you use one.
  • Whether your network allows ifinityagentz.co.uk. Ask your IT team if your organisation filters websites.

The pill goes back to normal when AgentZ reaches the service again. You do not need to sign in again.

The sidebar shows a line API under your iMIS site only while the iMIS API connection is not working. It reads Not connected, or what AgentZ is doing, such as Connecting….

Go to Settings > Overview and look at the iMIS API check. If it shows Not connected, click Check the iMIS API. See Setting up the iMIS API connection.

AgentZ Design says “AgentZ is not signed in to licensing — showing the AgentZ default” and shows Default look, Version 0 and Last updated never.

AgentZ Design reads your organisation’s design sets from iFINITY’s service. It shows the default when AgentZ cannot reach the service, or you are not signed in. Check the pill at the top right for Reconnecting to the AgentZ service (above), then open Tools again.

AgentZ Design shows Save conflict: someone else changed this design set since you opened it.

Click Reload latest. Your changes on screen are not kept, so make them again on the latest version, then save. See AgentZ Design.

AgentZ Design shows Save failed, or Sync failed with “Could not sync AgentZ Design.”

Check for Reconnecting to the AgentZ service at the top right (above). When AgentZ is connected, try again. Click Close to close the message.

Website Migration shows a short message, such as “Could not list projects.”, “Could not read the project.”, “Project creation failed.”, “Snapshot preview failed.”, “Batch write failed.”, “Rollback plan failed.” or “Rollback failed.”, or the error your agent reported.

Website Migration works through an agent in your AI app. Check the following:

  • An agent is connected. The top of Website Migration says how many agent sessions are available. If none is, start a conversation in your AI app with AgentZ.
  • The iMIS API is connected. See Settings > Overview.

Then try the same step again. If a write or a rollback failed, check the project’s stage in Website Migration before going on. See Website Migration.

Activity is unavailable, or This session is no longer recorded

Section titled “Activity is unavailable, or This session is no longer recorded”

All activity shows Activity is unavailable, or an agent’s page shows This session is no longer recorded.

The agent’s record is no longer in AgentZ, for example because it ended long ago. Close All activity and open it again from the sidebar. Finished work you or your team shared stays under History.

You pressed Stop, Resume, Take over the browser, Hand back the browser or Cancel this step, and AgentZ shows “AgentZ did not answer. Try again.”, “That did not work.”, or “That did not reach AgentZ”.

Press the button again. If it keeps happening, quit AgentZ completely and open it again. Stopping or taking over is described in Stopping and resuming agent work and Taking over from an agent.

The agent’s page in All activity shows no Stop, Take over the browser or Cancel this step.

The agent is running an older AgentZ plugin, which cannot be stopped or handed the browser from the AgentZ app. Update the AgentZ plugin in that AI app, then start a new conversation. See Plugin update troubleshooting.

A step in All activity shows “No result was recorded for this step”, “The full output is no longer available”, or “The result view is unavailable”.

The step ran, but its full result was not kept or cannot be shown here. Ask the agent in your AI app what the step returned.

Do I lose my work when AgentZ shows Reconnecting to the AgentZ service? No. You stay signed in, and AgentZ keeps trying by itself.

Should I sign out and in again when a page does not open? No. Signing out does not help a page that cannot load. Check the line under We couldn’t open, then click Try again.

What do I send iFINITY support? What the message said, the text under Technical details where there is one, and your app version from Settings > AgentZ. See Contacting iFINITY support.