Anmelden Kostenlos starten

Tool-Referenz — Anzeigen

General tools

Account status, campaign summary, reports, approval queue, brand profile and channel-independent change tools.

Toolnamen und Beschreibungen werden direkt aus dem Servercode erzeugt; die Beschreibungen sind der englische Originaltext, den der Assistent sieht.

Lese-Tools10 Tools

get_status

Lesen1 Credits

Account overview: brand, plan, connected platforms, campaigns (7 days), pending approvals, open customer chats, spend guard. Call first when context is unknown.

Dieses Tool hat keine Parameter.

list_accounts

Lesen1 Credits

Connected ad and data accounts (google, meta, microsoft, tiktok, linkedin, ga4, search-console, gbp, whatsapp) with status. 'sample' connections are demo data, not live.

Dieses Tool hat keine Parameter.

list_campaigns

Lesen1 Credits

Campaigns with the last N days of spend, clicks, orders and revenue. Use the returned campaign ids for update_campaign / add_negative_keywords.

Parameter	Typ	Beschreibung
`days`Optional	integer (1–90)	—

get_report

Lesen1 Credits

Period report: spend, orders, revenue, ROAS, change versus the previous period, suggestions. Read only.

Parameter	Typ	Beschreibung
`period`Optional	day \| week \| month	—

search_terms_report

Lesen2 Credits

Google Ads search terms with spend, clicks and conversions for the last N days, plus the wasted (zero-conversion) terms. Requires a connected Google Ads account; otherwise returns a note, never invented numbers.

Parameter	Typ	Beschreibung
`days`Optional	integer (1–90)	—
`campaign_id`Optional	string	—

account_audit

Lesen3 Credits

Account hygiene audit as prioritised findings: spend without results, missing budgets, no spend cap, wasted search terms, pending approvals. Read only.

Dieses Tool hat keine Parameter.

list_pending_approvals

Lesen1 Credits

Changes waiting for the user's approval (id, kind, title).

Dieses Tool hat keine Parameter.

get_brand_profile

Lesen1 Credits

Brand knowledge base: sector, location, products, audience, goals, tone, competitors.

Dieses Tool hat keine Parameter.

research

Lesen2 Credits

Web research (competitor, price, sector rule). If no research provider is configured, returns a note; never invent results.

Parameter	Typ	Beschreibung
`query`Pflicht	string	—

list_customers

Lesen1 Credits

Customer conversations in the inbox (WhatsApp, Messenger, Instagram): who wrote, last message, waiting for reply.

Parameter	Typ	Beschreibung
`state`Optional	needs_you \| waiting \| auto \| done	—
`limit`Optional	integer	—

Schreib-Tools13 Tools

connect_account

Schreiben0 Credits

Start connecting a platform account. Returns an authorisation link the user must open (OAuth); nothing is connected without the user signing in.

Parameter	Typ	Beschreibung
`provider`Pflicht	google \| meta \| microsoft \| tiktok \| linkedin \| ga4 \| search-console \| gbp \| whatsapp \| shopify \| youtube	—

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

create_campaign

Schreiben2 Credits

Create a campaign DRAFT (paused). Going live is a separate step: update_campaign(op=publish) which passes the approval gate. Platforms without a live adapter return can_go_live=false with steps.

Parameter	Typ	Beschreibung
`name`Pflicht	string	—
`platform`Pflicht	google \| meta \| microsoft \| tiktok \| linkedin	—
`kind`Optional	string	search \| pmax \| display \| message \| traffic \| conversion
`daily_budget`Optional	number	—
`goal`Optional	string	—

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

update_campaign

Schreiben2 Credits

Pause / resume / change daily budget / publish a campaign. Returns a preview and status: applied, pending approval, or dry run. Nothing is applied without the user's approval policy allowing it.

Parameter	Typ	Beschreibung
`campaign_id`Pflicht	string	—
`op`Pflicht	pause \| resume \| budget \| publish	—
`amount`Optional	number	daily budget for op=budget

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

set_budget

Schreiben2 Credits

Set a platform-level budget (no campaign id needed). Goes through preview and approval; increases above 50% per change are blocked.

Parameter	Typ	Beschreibung
`platform`Pflicht	string	—
`amount`Pflicht	number	—
`currency`Optional	TRY \| USD \| EUR	—
`period`Optional	day \| week \| month	—

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

add_negative_keywords

Schreiben2 Credits

Add negative keywords to a Google Ads campaign. Creates an approval item with a preview; applied to Google only after approval and only with a connected account.

Parameter	Typ	Beschreibung
`campaign_id`Pflicht	string	—
`keywords`Pflicht	array<string>	—
`match_type`Optional	BROAD \| PHRASE \| EXACT	—

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

create_rule

Schreiben2 Credits

Turn an 'if … then …' sentence into an automation rule (mode=ask puts each trigger into approval, auto applies within the spend guard).

Parameter	Typ	Beschreibung
`sentence`Pflicht	string	—
`mode`Optional	ask \| auto	—

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

set_spend_guard

Schreiben1 Credits

Profit guard: daily/monthly spend caps, target CPA, margin, average order value, autopilot.

Parameter	Typ	Beschreibung
`daily_cap_try`Optional	number	—
`monthly_cap_try`Optional	number	—
`target_cpa_try`Optional	number	—
`margin_pct`Optional	number	—
`aov_try`Optional	number	—
`autopilot`Optional	boolean	—

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

approve_action

SchreibenUnumkehrbar5 Credits

Apply a pending change. Only call after the user explicitly said to approve it; pass confirm=true. Returns applied / dry run / failed.

Parameter	Typ	Beschreibung
`action_id`Pflicht	string	—
`confirm`Pflicht	boolean	must be true; only after the user explicitly approved

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

reject_action

Schreiben0 Credits

Reject a pending change.

Parameter	Typ	Beschreibung
`action_id`Pflicht	string	—

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

set_brand_profile

Schreiben1 Credits

Write brand profile fields when the user describes the business.

Parameter	Typ	Beschreibung
`fields`Pflicht	object	business.sector, business.location, goals.target, products.list, audience.primary, competitors.list, brand.tone …

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

draft_ad_copy

Schreiben2 Credits

Ad copy drafts (headlines, descriptions, call to action) from the brand profile.

Parameter	Typ	Beschreibung
`platform`Optional	google \| meta \| instagram	—
`kind`Optional	string	—

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

reply_customer

Schreiben2 Credits

Reply to a customer thread on the user's behalf (only when the user dictated or approved the text).

Parameter	Typ	Beschreibung
`thread_id`Pflicht	string	—
`text`Pflicht	string	—

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

generate_content

Schreiben3 Credits

Studio: generate an image, short video, UGC video, voice-over or script from a brief. The script is immediate; files take minutes and need an AI route.

Parameter	Typ	Beschreibung
`kind`Pflicht	string	image \| short_video \| ugc_video \| voice \| script
`brief`Optional	string	—
`campaign_id`Optional	string	—

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.