> ## Documentation Index
> Fetch the complete documentation index at: https://talktohumans.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 🪄 AI actions

You open the composer. The cursor blinks. Suddenly you have forgotten how words work.

We all get the blank-page effect. AI actions give you a useful starting point that you can tweak, or help improve something you already wrote.

Default actions include **Proofread**, **Draft reply**, **Personalize**, **Shorter**, and **Translate**.

## Start from a blank composer

Use **Draft reply** when you know what the conversation needs but cannot find the first sentence. TalkToHumans can use the recent thread, person, and company context to give you a base.

Then make it yours. Add the detail the AI missed, remove the generic line, and check that you would actually say it that way.

## Improve your own draft

Already wrote something? Good. AI is often more useful as an editor than a ghostwriter.

Use actions to:

→ proofread a message
→ make it shorter
→ translate it
→ sharpen the call to action
→ personalize it with relevant context

You keep the idea and tone. The action helps with the annoying last 20%.

## Run an AI action

<Steps>
  <Step title="Open a conversation">
    Write a draft first when the action should edit your words. Leave the composer empty when you want **Draft reply** to start from the conversation.
  </Step>

  <Step title="Open AI actions">
    Click the AI control in the composer or type `,,`.
  </Step>

  <Step title="Choose the action">
    Select an existing action or enter a quick prompt. TalkToHumans sends the relevant draft and context to the selected AI model.
  </Step>

  <Step title="Review the result">
    The result returns to the composer. Read it, fix anything that sounds generic or wrong, then send or schedule it yourself.
  </Step>
</Steps>

## Create your own action

From the AI actions menu, choose **Create AI prompt**. Give it a name, prompt, model level, and personal or shared scope.

You can include these context variables:

| Variable           | Context added                          |
| ------------------ | -------------------------------------- |
| `{{draft}}`        | The current message in the composer    |
| `{{conversation}}` | Recent messages in the thread          |
| `{{member}}`       | The person's available profile details |
| `{{company}}`      | The person's available company details |

Example:

```text theme={null}
Rewrite {{draft}} so it sounds concise and specific.
Use {{conversation}} to answer the person's actual question.
Use {{member}} and {{company}} only when the detail is relevant.
Do not invent facts. Return one message with no commentary.
```

## A good shared action

A shared action works best when it captures a repeatable writing standard:

→ Keep the reply under 70 words.\
→ Answer the question before adding a call to action.\
→ Use profile context only when it changes the message.\
→ Preserve the sender's tone.\
→ Never invent a case study, number, or mutual connection.

AI actions do not currently contain a full company knowledge base or uploaded ICP document by default. Put stable company context into the prompt when needed, and keep the instruction narrow enough to review quickly.

## Credits and data

Each AI run consumes credits. The model selector shows the credit cost before you save a prompt, and your balance appears under **Settings → Usage & plans**.

The requested action may send the selected draft, conversation, person, and company context to an AI provider. TalkToHumans does not use customer content to train general-purpose AI models unless the customer authorizes it in writing.

<Warning>
  Please do not send AI-generated messages blindly. AI can sound very confident while getting the person, claim, date, link, or promise completely wrong. Use the result as a base, read it like the sender you are, then make it yours.
</Warning>