Tools

• search

  Search the workspace

  Finds posts, files, campaigns, accounts, queues, scripts, Studio projects and styles, by words or by what a picture or video shows.

  Risk

  Low

  Connector

  Both

  Reads only

• fetch

  Read one thing in full

  Reads a post, file, campaign, queue, account or Studio project from its link or id, or a page of SPREVA's reference.

  Risk

  Low

  Connector

  Both

  Reads only

• overview

  Workspace overview

  The first call in a conversation: the time zone and clock, what needs attention, what goes out next, the accounts, queues and campaigns, and what the plan allows.

  Risk

  Low

  Connector

  Both

  Reads only

• save_post

  Create or edit a post

  Writes a post for one or more accounts, with what differs per account, and sets when it goes out: a time, a queue's next slot, or a draft.

  Risk

  Medium · High when it goes out in less than an hour.

  Connector

  Both

• publish_post

  Publish a post now

  Publishes a post on all its accounts, or again only where it failed. What already went out is never posted twice.

  Risk

  High

  Connector

  Both

• delete_post

  Delete a post

  Removes a draft, a scheduled post or a published one from SPREVA. A published post stays live on the networks.

  Risk

  Medium · High for a published post.

  Connector

  Both

• import_media

  Import a file into the library

  Brings an image or a video into the library from a public link, or from bytes the agent uploads.

  Risk

  Medium

  Connector

  Both

• update_media

  Rename, tag, file or describe a library file

  Changes a file's name, tags, folder or alt text, and can write the alt text from what the picture shows.

  Risk

  Medium

  Connector

  Both

• save_campaign

  Create or edit a campaign

  Creates or changes a campaign, and adds posts to it or takes them out.

  Risk

  Medium

  Connector

  Both

• save_queue

  Create or edit a queue

  Creates or changes a posting schedule: its name, time zone and weekly slots.

  Risk

  Medium

  Connector

  Both

• analytics

  How posts performed

  Totals against the period before, the top posts, the split by network and comparisons with their sample sizes, for the workspace, a campaign, an account or a post.

  Risk

  Low

  Connector

  Both

  Reads only

• create_video

  Create a Studio video

  Starts an empty Studio project in a format, which the agent then builds.

  Risk

  Medium

  Connector

  SPREVA only

• narrate_video

  Narrate a Studio video

  Voices the script the agent wrote and places every word on the timeline. Spends the plan's voice characters.

  Risk

  High

  Connector

  SPREVA only

• edit_video

  Change a Studio video

  Edits text, timing, cuts, pictures, clips, effects and sound, and adds new elements, with the Studio's own editing operations.

  Risk

  Medium

  Connector

  SPREVA only

• review_video

  Review a Studio video

  Checks a project the way the Studio's own AI editor checks its work, and lists what to fix, worst first.

  Risk

  Low

  Connector

  SPREVA only

  Reads only

• render_video

  Export a Studio video

  Exports a project to an MP4 or a PNG in the library, ready to go in a post.

  Risk

  Medium

  Connector

  SPREVA only

• generate_image

  Generate an image

  Makes a new image from a description, in one of the workspace's styles if asked. Spends one image of the plan's AI allowance.

  Risk

  High

  Connector

  SPREVA only

An agent starts with overview for the time zone, the clock and the accounts, finds things with search, reads one in full with fetch, and changes it with save_post or another tool. Every answer says what can be done next.

Tools take what a person would say: an exact file name, an @handle, a campaign's name, or a link to anything in SPREVA, pasted from the browser or from an earlier answer. Searching is forgiving and changing is not: a name that matches several things comes back as a choice, and nothing is saved until one is chosen.

An agent reads SPREVA's reference with fetch when it needs it, rather than carrying it in every call:

• spreva://docs/platforms/tiktok, and one page per network: what it accepts, lengths and options.
• spreva://docs/queues: times, time zones and queues.
• spreva://docs/agent-permissions: risk levels, confirmations, revisions and request ids.
• spreva://docs/studio/making and spreva://docs/studio/editing: building a video, on SPREVA only.