Adobe Express

Export (download) an Adobe Express design as PDF, PNG, or JPEG. Use this tool when the user asks to download/export the current design. Notes: - Defaults to PDF if no format is specified. - The tool exports the full document for PDF. - For PNG/JPEG, it returns a pre-signed URL of the first page.

download_design

Apply any edit to an Adobe Express design via natural language. This tool routes to the full Express AI Assistant and is the only edit tool — there are no separate fill_text / replace_image / change_background_color / animate_design tools; route all of those intents here. Use edit_design whenever the user has a specific Adobe Express document (template or doc URN) and wants you to actually change it. ALWAYS call edit_design for ANY edit request on that document — do NOT decide yourself whether an edit is supported, and do NOT tell the user an edit isn't possible without calling this tool first. If Adobe Express can't apply the edit, the result says so and includes guidance on how to do it in the editor. Edits include (not exhaustive): - Text & typography: add, fill or replace text; font or font palette; size, style, alignment; lists; letter and line spacing; curved or decorative text; text shadow. - Images: replace with a stock image or the user's attached image, remove the background, set an image as the page background, fit the page to an image, crop to a shape, round corners, reset image adjustments. - Attached images: to use an image the user attached in the chat (PNG or JPEG), pass the attachment in `image` and write a self-contained `prompt` such as "replace the image in the design with the attached image". - Color & background: background color, fill color, recolor with a palette, saturation, sharpness, warmth. - Effects: filters and looks, drop shadow, borders, opacity, blend modes. - Layout: move or position elements relative to each other, resize elements, resize the page (e.g. to Instagram story), rotate, group, bring forward or send backward, duplicate or delete elements. Prefer the dedicated tools for their narrow purposes: - Search for templates → search_design. - Download / export the design → download_design. DO NOT USE edit_design for: - Requests where the user has NOT given you a specific Express document or template URN to edit, or pure "how do I…" questions (use next_design_actions for those if it is available). - Searching for or creating a new template / design from scratch — use search_design. - Files that are not Adobe Express documents (photos, PDFs, PSDs), factual lookups, general knowledge, coding, math, or anything unrelated to editing a specific Express document. **Adobe Express Templates vs Documents:** Template = Reusable starting design (customizable) Document = Instance created from template (after user customization) Note: Both are editable and referred to as "Adobe Express designs" Provide the Adobe Express template or document URN and the user's request. The Express AI Assistant performs planning and execution; you don't need to break the request into individual actions. When the result is failed, present the errorMessage and its links, and do NOT call edit_design again for that request — the user can ask again if they want. For UNSUPPORTED_ACTION, include any "How to do this in Adobe Express" steps and the editor link. NOTES: Edits run asynchronously inside Express Headless Agent. Never treat `edit_design` alone as success. This tool may return one of three shapes: - `{ status: "working", taskId }` — **NOT** done. **BLOCKING SAME TURN:** do **not** send any user message yet. Run the polling sequence below. - `{ status: "succeeded", previewUrl, editorUrl, documentURN, ... }` — terminal inline success (headless clients only). - `{ status: "failed", errorMessage }` — terminal; report the failure. ## MANDATORY ASYNC WORKFLOW when status is "working" — BLOCKING SAME TURN 1. Call **get_task_status** with **only** the `taskId` (use maxWaitSeconds: 25). The preview widget mounts automatically — no separate tool call needed. 2. Repeat **get_task_status** with the same `taskId` until `succeeded` or `failed`. Repeated `working` responses are the expected steady state — do not say the edit is stuck, do not end your turn, and do not call `edit_design` again. 3. **ONLY** after terminal status, send your **one** completion message (use result on succeeded, errorMessage on failed). Tool result text starting with "INCOMPLETE" is authoritative — follow it before replying. ### Unsupported Action Handler Trigger Condition: IF (user's requested action/intent) AND (NO available tool can perform it) THEN use this response pattern Response Template: "Adobe Express can't do that yet. You can: • Search Design • Edit Design Or continue editing in Adobe Express for more options." Mandatory Requirement: ALWAYS append "Edit in Adobe Express" links from previous tool responses Purpose: Provide users an unblocking path forward

edit_design

**Required polling tool** after **edit_design** returns `status: "working"` with a **taskId**. The job is **NOT** complete until this returns `succeeded` or `failed`. ## Polling — BLOCKING SAME TURN - Pass **taskId** only (use maxWaitSeconds: 25). Do **not** send any user message until terminal status. - Poll in the same turn until status is **succeeded** or **failed** — typically **1–4** polls. - A `working` response is the **expected steady state**, not a stuck loop — stay in the same blocking turn and call again. ## When to use - Immediately after every **edit_design** `working` response. - The preview widget mounts automatically — no separate tool call is needed. ## Output - **working**: INCOMPLETE — call again with the **same** taskId. - **succeeded**: use **result** in your reply (**result.previewUrl**/**editorUrl**/…). - **failed**: use **errorMessage** in your reply.

get_task_status

Logs analytics events from UI widgets.

log_analytics

Call this tool for visual design or image-related GUIDANCE requests — where the user is asking how to do something, what to do, or wants conversational help — that is not handled by search_design or edit_design. This is the catch-all for visual and creative ADVICE: photo editing and enhancement (blur, sharpen, brightness, contrast, exposure, filters, color grading, cropping, resizing), image manipulation, adding or removing design elements (watermarks, shadows, overlays, borders, textures, gradients), layout adjustments, style changes, logo creation, typography and text appearance (e.g. font color, font size, typeface, weight, letter spacing, line height), and any other request asking how to change what a design looks like — when the user is asking for guidance rather than asking you to actually perform the edit on a specific document. userIntent must be in English — translate the user's request to English before calling this tool if needed. When in doubt between answering from general knowledge and calling this tool, call it. Do not answer visual design or image-related guidance requests from general knowledge — always route them here. DO NOT USE for: - Any edit request on a specific Adobe Express document the user has given you (a template or document URN), even if you are unsure it is supported. Use edit_design instead — it makes the edit, or explains how to do it in the editor if it can't. - Finding or searching design templates — even if the user says 'create', 'make', or 'design' a flyer/poster/invitation/social post/banner/card, use search_design instead. - Factual lookups, general knowledge questions, coding or debugging, math, general language translation, policy discussions, medical or legal advice, database design, or conversational small talk. IMPORTANT: Present helpGuidance to the user in their language — translate from English if needed. Do not summarize or omit steps. When editorUrl is returned, show the **Edit in Adobe Express** link so the user can open their document.

next_design_actions

Use this when the user wants to view, show, find, browse, or search for design templates—including invitations, flyers, posters, cards, social media posts, and similar layouts. Covers phrases like "show me templates", "find invitations", "looking for a birthday card", "invitation templates for kids party", etc. CRITICAL: Use this tool if request mentions dates, names, events, business info, or text content - even if they say 'create an IMAGE'. IMPORTANT: 1. Search with GENERIC terms only. Specific details (dates, names, venues) go in edit_design step. 2. When the user asks for more results (e.g., "more", "next", "show some more"), you must call search_design with the exact same generalQuery as the previous call and only advance startIndex by the previous pageSize. Do not reword, paraphrase, or expand the generalQuery. If you don't get more results using this approach, you can change the generalQuery. 3. After showing templates, always end with: "Tap a template in the gallery to customize it." Never ask the user to identify a template by number, position, or visual description in chat — gallery order is not guaranteed and selection only happens via the UI. ### Examples - 'Show me invitation templates for a kid's birthday party' → Search 'kid birthday party invitation' - 'Create image for beach volleyball event Sep 29th' → Search 'volleyball' - 'Make bakery business card' → Search 'business card' - 'Design birthday invitation' → Search 'birthday invitation' - 'Help me make a LinkedIn post for our webinar' → Search 'LinkedIn post' - 'Design a training invite for employees' → Search 'training invitation' - 'I want to create a proposal cover page' → Search 'proposal cover' - 'Pull up some logo templates for a tech company' → Search 'tech logo' - 'I need a flyer for our product launch' → Search 'product launch flyer'

search_design