Help · version 0.1.13

Use the Assistant

Use Assistant when you know what you want to achieve and want help preparing the work. Your tasks, contacts and conversations can supply context; you remain able to inspect and edit the underlying information directly.

Assistant in the example workspace before a model is connected

Connect a model

Open Settings → Assistant & agents → Models & API keys. Add your API keys under Providers and API keys, then choose models for text replies, image generation, speech synthesis and audio transcription under Models by activity. You can use different providers for each activity. Local AI requires a compatible server reachable from your Hub. Cloud providers receive the content needed for the selected activity and may charge for usage. Account sign-in for Codex is available under Customize engines & tools.

See Settings and customization for the connection options, model setup and external MCP agents.

Ask for an image or a spoken reply

Ask directly in your own words. For example, say “Crea un’immagine di Milano al tramonto” or “Puoi rispondermi con un vocale?”. The Assistant uses the image or speech model you selected in Models & API keys.

You can write the request or dictate it with the Gravify microphone, then review and send the transcription. In your dedicated WhatsApp assistant chat you can also send a voice note when automatic transcription is enabled.

If you prefer a shortcut, use /voice or /vocale to request a spoken reply. Use /image or /immagine followed by the description to generate an image. The shortcuts work in both chats. Ask the Assistant what commands are available and it can look them up in this Help article.

Give it a concrete request

  1. Open Assistant and choose your model.
  2. Drag the relevant task, person or conversation into the composer.
  3. Say what you want, such as “Help me plan the next steps for this project”. Include dates or constraints that matter.
  4. Read the response and inspect any proposed changes before applying them.

Use New chat for a fresh conversation and Past chats to return to earlier work. A calendar proposal is not the same as an applied event: use its review controls and check the resulting calendar.

Use WhatsApp from your local agent

You can also use Gravify as context for an agent you already use, independently of the secretary inside Gravify. Selecting Use my own AI agent during setup only prepares the menu and offers configuration; it grants no data access.

Before creating a connection, open Review data access and inspect the current permissions. Return and explicitly acknowledge that your agent may send permitted context to its AI provider. An unsuccessful permission review keeps new connection creation locked. Viewing permissions does not change them. Existing connections can always be revoked without accepting new access.

In Settings → Assistant & agents → Connect or manage agents, use Set up Codex on this computer or Set up Claude Code on this computer. Restart that client to load the Gravify tools. Other local MCP clients can use the displayed URL and Authorization header with Streamable HTTP. Cloud chat clients cannot directly reach the local Hub address.

After connecting WhatsApp, your agent can read authorized retained messages, find conversations awaiting your reply, prepare drafts and compare interaction frequency across periods. Text reading requires full local history mode. Initial import and permissions determine the available context; unread status alone does not establish urgency.

For installation steps and a prompt your computer-capable agent can follow, see Set up WhatsApp with your AI agent. Keep the computer and Hub running; enable Run Gravify in the background and choose Always Ready for MCP access with the window closed.

Keep control of your context

Relevant private context is sent to the model you choose. Use only the context needed for the request. Your personal contact note and the separate Agent note have different purposes; the Agent note does not replace your own writing. Human communication still needs explicit approval: an assistant response or draft is not a sent message.

Drafts, permissions and product help

On desktop, Drafts and Assistant permissions have their own icons in the main side menu. Drafts opens pending work across chats; permissions controls which context the assistant may read. Scroll the side menu when the window is too short to show every command.

You can ask the assistant or a connected MCP agent to consult the included user manual. If you report a bug, it can help describe the reproduction steps and expected and actual behavior, then prepare an email to support. Review the text and choose its email link to open your mail app; you send it yourself. Logs, private conversations and credentials are never attached automatically.

An eligible paid licence holder can also ask for a link to give a friend three calendar months of Gravify while the promotion is enabled. Share the prepared invitation yourself. Each recipient must be a new user who has never activated Gravify and has no purchased or gifted licence. The three months start at their first app activation; no card is required. Getting the link needs an internet connection to the account service.