TOOL API
tiktok_ ads_ diagnosis_ agent
Call this tool when the user has any of the following intents: get ad performance data, identify potential issues, find opportunities, or receive optimization recommendations. This tool supports scenarios including overall performance diagnosis for accounts, non-GMV Max campaigns, or ad groups. It can analyse issues including no spending, no delivery, no impressions, low budget utilization, declining spending, high CPA, declining conversion efficiency, and creative fatigue or declining creative performance. The tool also supports multi-turn follow-ups for additional explanations or changes to the time range, benchmark, or diagnosis object. Session and turn handling (read carefully — this tool does not keep state for you): - This tool is stateless between calls. YOU (the calling agent) own the conversation's session_id. - The first time a user starts a diagnosis conversation, generate a new session_id. - For every follow-up turn that belongs to the SAME diagnosis conversation (more suggestions, more explanation, a different time period, a new benchmark, correcting the diagnosis object), reuse the same session_id as context so continuity is preserved. - Start a new session_id only when the user begins an unrelated, new conversation.
Call information
- Tool slug
- tiktok-ads.tiktok_ads_diagnosis_agent
- Provider
- TikTok for Business
- Average response
- 0 ms
- Calls in 7 days
- 0
Input parameters
ctxrequiredDiagnosis context.
messagesrequiredMessage list of the current turn. Contains only the latest user question of this turn.
session_idUnique ID of the conversation session, owned and generated by the calling agent. All turns of the same multi-turn diagnosis conversation must share the same session_id so AOS can use previous answers and interactions as context. Character limit: 32.