AdCopilot docs
Troubleshooting

A tool is missing or out of date

Your assistant keeps the tool list from when it connected. How to tell when it is stale — the "Tools revision" stamp and get_org_context(tools=[…]) — how to reconnect so it picks up new tools, and what a Google product you just connected needs.

View as Markdown
Open inChatGPTClaudePerplexity

Your AI assistant fetches AdCopilot's tool list when it connects, and keeps that copy. After a release adds tools, the copy can be out of date until you reconnect.

AdCopilot tells you

get_org_context, the first call of every conversation, compares your connection's tool list with the current one. When tools are missing it says so:

2 AdCopilot tools (list_asset_links, set_campaign_asset_status) are available but not in this connection's tool list, which was loaded before they became available — to use them, in Claude, open Customize → Connectors (the Claude connect guide has a direct link), choose AdCopilot, press Disconnect, then connect it again.

The fix it names depends on your assistant. See Reconnect your assistant.

A product you just connected is missing

When you connect a Google product, there is nothing to do in your AI app. When you approve your assistant, AdCopilot asks for every Google product it serves, so the product's tools are already in its list and work on the next request.

If they are missing or refused, your assistant's approval does not cover that product: for example, it was approved when AdCopilot asked for Google Ads alone. Connections marks such an app Re-authorization needed, and AdCopilot says so in the chat. Revoke it under Connections and approve it when it next asks, or remove the AdCopilot connector in your AI app and add it back. See Approve your assistant again.

A description is out of date

A description is the tool's instructions. An old copy can make the assistant do the old thing. Every description AdCopilot serves ends with one line:

Tools revision: 1a2b3c4d.

get_org_context reports the current revision. If a description your assistant holds ends with a different revision, or has no such line (some clients cut long descriptions), ask:

Call get_org_context with tools=["full_audit"] and use that description.

get_org_context(tools=[…]) returns the current text of up to ten named tools, ending with the current revision line. It changes nothing and does not count against your daily operations. When descriptions have changed, get_org_context also says which ones:

1 AdCopilot tool description (full_audit) changed after this connection's tool list was loaded — get_org_context with tools=[…] returns the current text; to refresh the whole list, …

Reconnecting your assistant refreshes all of them at once.

Still missing after reconnecting

  • The product is not connected, or is read-only. Write tools for Google Analytics and Tag Manager need Enable editing in Google products. See A Google product is not connected.
  • You are a viewer. A teammate with the viewer role gets read tools only.
  • The workspace is read-only, after a cancelled or unpaid subscription. See Billing and payment issues.
  • Some clients load tools lazily. Ask for the tool by name; the assistant can fetch it. A tool missing from the first list is not proof it is unavailable.

On this page