Plus AI

Open the Plus AI presentation panel or refresh an existing session. Pass a session ID from create_presentation_with_agent to view its slides, select a slide for edits, and download its PowerPoint and PDF. Without an ID, open the recent-PowerPoints picker. This never starts generation.

open_presentation

Continue working on a deck the Presentation Agent made earlier. Edits the session's presentation in place and returns the updated PowerPoint, PDF and thumbnail. Use this for every follow-up change to a deck instead of creating a new one. Each change uses the user's AI credits. This tool returns within about 45 seconds. If the change takes longer it returns status RUNNING: call get_presentation_agent_session with the sessionId until it returns the updated files, and don't send the same change again.

Create a presentation based on the given prompt.

Create or edit a presentation with the Plus AI Presentation Agent. The agent plans, designs, and iterates on the deck, so it produces higher quality presentations than create_presentation but takes longer (typically a few minutes). Pass pptx_file_id to have the agent work on an existing deck instead of starting fresh. For follow-up changes to a deck this tool made, use continue_presentation_agent_session instead of calling this again. This tool returns within about 45 seconds. Decks usually take a few minutes, so expect a sessionId with status RUNNING: tell the user the deck is being made, then call get_presentation_agent_session with that sessionId until it returns the files. Don't call this tool again for the same request; that starts, and bills, a second deck.

Wait for a presentation agent session started or continued earlier. Waits up to about 45 seconds for the agent to finish its latest request, then returns the download links, or status RUNNING if it is still working. While it is RUNNING, call this again with the same sessionId: each call waits again, so there is no need to pause between calls.

List files in the user's Plus AI workspace, newest first. Use it to find the file id of a PowerPoint the user wants edited, and pass that id as pptx_file_id to create_presentation_with_agent. Files get here through upload_file, when the user drops a .pptx on the New presentation page at app.plusdocs.com, or through the Plus AI API. If the deck isn't listed (follow nextCursor to look further back), upload it with upload_file.

Upload a PowerPoint (.pptx) to the user's Plus AI workspace, so the Presentation Agent can edit it. - If the user attached the .pptx in this chat, pass it as `file`. The deck is uploaded for you. - Otherwise, if you can read the file and run shell commands, pass its path as `file_name`, then run the returned upload.command. Either way, pass the returned fileId as pptx_file_id to create_presentation_with_agent. Uploads are kept for 8 days; the agent edits a copy, so the original is never changed.