GTM.ai
Sign up
Docs menu

Troubleshooting Agent Team Runs in GTM One

Learn how to find out why an Agent Team run failed and how to start it again.

Srivatsa MarthiSrivatsa MarthiPrincipal Product Manager

Learn how to find out why an Agent Team run failed and how to start it again.

Overview

Agent Teams is part of GTM One and shares its teams and runs with GoToMarket Studio. A team your organization builds in one appears in the other. Each run of a team is listed on the team's Runs tab, with each step's output, its inputs and any files it produced.

This article covers the runs that do not finish: a run that is refused or fails because of credits, a run that ends with a failed status, and the options for running it again. A run that fails or is stopped is still charged for the work it did.

Starting a new run can send real emails, post Slack messages and change CRM records, and it spends AI credits from the balance of the person the run runs as. Check the team's steps before you run it again.

Before you start

  • Seeing the team. The Agent Teams entry in the left navigation appears only for people an admin has given the View permission. If it is missing, ask your ZoomInfo admin to assign it.
  • Starting a run. Running a team needs the Run permission, which an admin assigns. Without it you can read a team's runs but cannot start one. Changing a team's steps needs the Create and edit permission instead.
  • Credits. Runs use AI credits. Whether you can add credits or change a limit depends on your role; ask your ZoomInfo admin. See Overview of credits in GTM One for what each credit type covers.

Find out why a run did not finish

  1. In the left navigation, click Agent Teams.
  2. Open the team whose run did not finish.
  3. Click the Runs tab.
  4. Find the run and read its status and the message beside it.
  5. Open the run to see the output of each step. The last step with output shows how far the run got.

Then use the section below that matches what the run shows. For a run that stopped at an approval step, see Troubleshooting an agent team run that stopped at an approval step in GTM One. To have AI Builder read the run for you, see How to find out why an agent team run failed with AI Builder.

The organization has run out of AI credits

When the organization's AI credits run out, a run fails partway with the plain status Failed and a message that names the organization's credits. The run is charged for the work it completed before it stopped.

  1. Ask your ZoomInfo admin to add AI credits to the organization. An admin can also set up automatic top-ups; see How to Set Up Auto Top-Up for AI and Data Credits.
  2. Open the team and click Run in the team header, then start the run again with the same inputs. Read the estimated credit cost and the AI credits left before you confirm. The older run keeps its Failed status after credits are added.
  3. Open the Runs tab and check that the new run is listed and moves past Failed.

If the estimate is higher than the credits left, the confirm button becomes Edit run and the run does not start. The Runs page offers Buy AI action credits to add more. For other credit blockers, see Troubleshooting Agent Team Runs Blocked by Credits in GTM One.

A run shows "Failed - Budget exceeded"

A team can have a monthly credit budget. A run that would pass it does not start and shows Failed - Budget exceeded.

  1. Open the team and click the Settings tab.
  2. Under Credit Budget (optional), raise the monthly amount, or clear it to remove the cap. Only people with the Run permission can change it.
  3. Click the Runs tab, find the refused run and click Reinitiate on it. To queue every refused run, click Reinitiate all.
  4. Check that the run now leaves Failed - Budget exceeded and starts.

A run failed because a person's AI credit limit was reached

A person's own AI credit limit applies to runs that run as that person. A run past it fails with a message that names the person.

  1. Ask your ZoomInfo admin to raise that person's AI credit limit.
  2. Once it is raised, click Run in the team header and start a new run.
  3. Check the Runs tab to confirm the new run starts.

Run a failed run again

There is no re-run button for a failed run. Start a new run instead. The only exception is a run refused for the monthly budget, which can be reinitiated (see the budget section above).

  1. Open the team and click Run in the team header.
  2. In the Run Agent Team dialog, choose the Data source (optional): Audience, CSV, Form input or Run without inputs, and enter the same inputs the failed run used.
  3. Choose Run as Me or Run as Others. The run uses the access and AI credits of the person it runs as.
  4. Click Next until the Review & Run step opens, check the estimated credit cost, then click Confirm and Run.
  5. Open the Runs tab and check the new run's status.

To choose a data source and its options in full, see How to Run an Agent Team Manually in GTM One.

You cannot start a run

The Run button can be missing or unavailable when you do not hold the Run permission. Whether you can run a team depends on your role; ask your ZoomInfo admin to assign the Run permission. See Troubleshooting Permission to Run Agents in GTM One and Overview of permissions in GTM One.

A run produced no result you can find

A run's output is on the team's Runs tab. A team can also deliver its output somewhere else, depending on its steps.

  1. Open the Runs tab and open the run to read each step's output and any files.
  2. If the team has an Activity Feed step, open the Agents tab in the Feed to find the update.
  3. If the team has an Email, Slack or Teams step, check that email inbox or channel.

If you see an error

  • "Failed - Budget exceeded": The run would pass the team's monthly credit budget, so it did not start. Raise the budget under Settings, then click Reinitiate on the run.
  • "Failed": When the message names the organization's credits, the organization ran out of AI credits partway through. Ask your admin to add credits, then start a new run.

Resources