Connexion Commencer gratuitement

Référence des outils — Publicité

General tools

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

Les noms et descriptions des outils sont générés directement depuis le code du serveur ; les descriptions sont le texte anglais d'origine vu par l'assistant.

Outils de lecture10 outils

get_status

Lecture1 crédits

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

Cet outil ne prend aucun paramètre.

list_accounts

Lecture1 crédits

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

Cet outil ne prend aucun paramètre.

list_campaigns

Lecture1 crédits

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

Paramètre	Type	Description
`days`Facultatif	integer (1–90)	—

get_report

Lecture1 crédits

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

Paramètre	Type	Description
`period`Facultatif	day \| week \| month	—

search_terms_report

Lecture2 crédits

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.

Paramètre	Type	Description
`days`Facultatif	integer (1–90)	—
`campaign_id`Facultatif	string	—

account_audit

Lecture3 crédits

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

Cet outil ne prend aucun paramètre.

list_pending_approvals

Lecture1 crédits

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

Cet outil ne prend aucun paramètre.

get_brand_profile

Lecture1 crédits

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

Cet outil ne prend aucun paramètre.

research

Lecture2 crédits

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

Paramètre	Type	Description
`query`Obligatoire	string	—

list_customers

Lecture1 crédits

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

Paramètre	Type	Description
`state`Facultatif	needs_you \| waiting \| auto \| done	—
`limit`Facultatif	integer	—

Outils d'écriture13 outils

connect_account

Écriture0 crédits

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

Paramètre	Type	Description
`provider`Obligatoire	google \| meta \| microsoft \| tiktok \| linkedin \| ga4 \| search-console \| gbp \| whatsapp \| shopify \| youtube	—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_campaign

Écriture2 crédits

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.

Paramètre	Type	Description
`name`Obligatoire	string	—
`platform`Obligatoire	google \| meta \| microsoft \| tiktok \| linkedin	—
`kind`Facultatif	string	search \| pmax \| display \| message \| traffic \| conversion
`daily_budget`Facultatif	number	—
`goal`Facultatif	string	—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

update_campaign

Écriture2 crédits

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.

Paramètre	Type	Description
`campaign_id`Obligatoire	string	—
`op`Obligatoire	pause \| resume \| budget \| publish	—
`amount`Facultatif	number	daily budget for op=budget

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

set_budget

Écriture2 crédits

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

Paramètre	Type	Description
`platform`Obligatoire	string	—
`amount`Obligatoire	number	—
`currency`Facultatif	TRY \| USD \| EUR	—
`period`Facultatif	day \| week \| month	—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

add_negative_keywords

Écriture2 crédits

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.

Paramètre	Type	Description
`campaign_id`Obligatoire	string	—
`keywords`Obligatoire	array<string>	—
`match_type`Facultatif	BROAD \| PHRASE \| EXACT	—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_rule

Écriture2 crédits

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

Paramètre	Type	Description
`sentence`Obligatoire	string	—
`mode`Facultatif	ask \| auto	—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

set_spend_guard

Écriture1 crédits

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

Paramètre	Type	Description
`daily_cap_try`Facultatif	number	—
`monthly_cap_try`Facultatif	number	—
`target_cpa_try`Facultatif	number	—
`margin_pct`Facultatif	number	—
`aov_try`Facultatif	number	—
`autopilot`Facultatif	boolean	—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

approve_action

ÉcritureIrréversible5 crédits

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

Paramètre	Type	Description
`action_id`Obligatoire	string	—
`confirm`Obligatoire	boolean	must be true; only after the user explicitly approved

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

reject_action

Écriture0 crédits

Reject a pending change.

Paramètre	Type	Description
`action_id`Obligatoire	string	—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

set_brand_profile

Écriture1 crédits

Write brand profile fields when the user describes the business.

Paramètre	Type	Description
`fields`Obligatoire	object	business.sector, business.location, goals.target, products.list, audience.primary, competitors.list, brand.tone …

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

draft_ad_copy

Écriture2 crédits

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

Paramètre	Type	Description
`platform`Facultatif	google \| meta \| instagram	—
`kind`Facultatif	string	—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

reply_customer

Écriture2 crédits

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

Paramètre	Type	Description
`thread_id`Obligatoire	string	—
`text`Obligatoire	string	—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

generate_content

Écriture3 crédits

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.

Paramètre	Type	Description
`kind`Obligatoire	string	image \| short_video \| ugc_video \| voice \| script
`brief`Facultatif	string	—
`campaign_id`Facultatif	string	—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.