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

# Chat

> Ask Connie to do work for you in plain language: start a chat, attach files, mention records, use skills and tools, and manage your chats.

Chat is where you talk to Connie, the AI assistant built into your workspace. You describe what you want in plain language ("find 50 SaaS founders in Berlin and add them to a list") and Connie does the work, using your Records, connected apps and the workspace's [Tools](/tools/overview) and [Skills](/skills/overview).

**Where:** left sidebar → **Chat** · `https://connie.ai/<workspace-id>/chat`

You can also open a chat beside the page you're working on with the **Ask Connie** button (the **AI Copilot** panel, see [below](#ask-connie-in-a-side-panel-ai-copilot)). For how workspace URLs work, see [Navigating Connie](/navigating-connie).

## What Connie can do in a chat

* Search, count and analyse your [Records](/records/overview), and create or update People, Companies, Deals and Tasks.
* Find new leads with [Lead Finder](/records/lead-finder).
* Build [Workflows](/automations/workflows/build). Connie leaves them as drafts until you ask it to turn them on.
* Read your [Inbox](/inbox/overview) and send email, LinkedIn and WhatsApp messages from your connected accounts.
* Search and read websites, and work in a browser through the Connie Chrome extension.
* Run code.
* Generate images, video and audio.
* Create pages, files and small web apps for you. These are called [artifacts](/chat/sharing-and-artifacts).
* Run instructions on a schedule inside a chat. See [Scheduled tasks](/automations/scheduled-tasks).

Before anything risky or paid (sending a message, deleting data, spending credits, changing many records), Connie stops and asks you. See [Approvals in chat](/chat/approvals).

## Start a chat

<Steps>
  <Step title="Open a new chat">
    Click **Chat** in the left sidebar, or click **New chat** (the pencil icon) next to **Recent chats**. An empty chat shows **What should we work on?**
  </Step>

  <Step title="Type what you want">
    Type in the message box (it says **Work with Connie**) and press **Enter** or click **Send**. Below the box you'll see up to three suggested skill cards; clicking one inserts that skill's `/command` for you.
  </Step>

  <Step title="Follow along">
    Connie replies and shows each step it takes. The first message creates the chat: it appears under **Recent chats** and the address changes to `https://connie.ai/<workspace-id>/chat?id=...`, which you can bookmark or send to a teammate who has access.
  </Step>
</Steps>

<Tip>
  You can keep typing while Connie is replying. The box says **Type to queue next message…** and your messages are sent in order when the reply finishes. See [Queued messages](#queue-messages-while-connie-is-working).
</Tip>

## Give Connie context with @mentions

An @mention points Connie at a specific item so it doesn't have to guess. For example, mentioning a list gives Connie that list's columns and contents for this message.

<Steps>
  <Step title="Open the Add menu">
    Type `@` in the message box, or click **+** at the left of the box.
  </Step>

  <Step title="Pick a category">
    Choose **Records** (lists and objects, plus single People, Companies and Deals), **Automations**, **Inbox** (conversations), **Tasks** or **Calls**. Suggested apps and tools appear under **Connectors**.
  </Step>

  <Step title="Search and select">
    Recent items show first. Type at least 2 characters to search everything. The item is added to your message as a mention.
  </Step>
</Steps>

You can mention lists and objects, individual People, Companies and Deals, workflows, Inbox conversations, tasks, calls, tools, connected apps and MCP servers.

## Use a skill with /

A [skill](/skills/overview) is a saved set of instructions (and often tools) for a specific job, like "ICP to LinkedIn Search". Using one tells Connie exactly how to do that job.

<Steps>
  <Step title="Type / at the very start of your message">
    A **Skills** list opens with up to 8 matches. Your workspace's own skills appear first, then Connie's built-in skills.
  </Step>

  <Step title="Pick a skill">
    Use the arrow keys and press **Enter** or **Tab**, or click it. Press **Esc** to close the list.
  </Step>

  <Step title="Add your request after the command and send">
    The skill's instructions and tools are loaded for that message.
  </Step>
</Steps>

If nothing matches you'll see "No matching skills". Check the command name, or press **Esc** to send your text as a normal message. Disabled skills don't appear. To create your own, see [Create and share skills](/skills/create-and-share).

## Choose tools (optional)

You don't have to pick tools. Connie finds the right tool on its own from everything enabled in your workspace: built-in tools, [connected apps](/tools/connect-accounts) and [your own MCP servers](/tools/custom-mcp-servers). A tool set to **Disabled** in [tool permissions](/tools/permissions) is never run.

To point Connie at a specific tool, account or workflow:

<Steps>
  <Step title="Open Add tools">
    Click **Tools** under the message box (full-page chat only), or **+** → **Browse tools**.
  </Step>

  <Step title="Find the tool">
    Search (**Search tools...**) or browse a category such as **Suggestions**, **My accounts**, **Enrichment** or **LinkedIn**.
  </Step>

  <Step title="Add it">
    Click **Add to chat**. Tools, workflows and records are added as mentions on your current message. Connected accounts and the **Inbox Messages** / **Email Threads** options are on/off switches that are saved when you close the dialog.
  </Step>
</Steps>

## Attach files

Click **+** → **Document**, drag a file anywhere onto the chat ("Drop your file anywhere in this panel to attach it."), or paste an image. You must type a message too: attachments can't be sent on their own ("Add a message to send").

| | Limit |
| - | - |
| Files per message | 10 |
| Size per file | 50 MB |
| PDFs | Under 32 MB |

Supported types:

* **Documents and data:** PDF, DOCX, TXT, Markdown, CSV, TSV, XLSX, JSON, JSONL, NDJSON, LOG
* **Images:** JPG, JPEG, PNG, GIF, WEBP
* **Code and web files:** HTML, CSS, JS, TS, Python, SQL, YAML, XML, SVG and most other code files
* **Video:** MP4, M4V, WEBM, MOV
* **Audio:** MP3, WAV, M4A, AAC, OGG

Old Excel `.xls` files can't be read. Save them as `.xlsx` first. Files you attached earlier in a chat stay available to Connie for later messages in that chat.

## Talk instead of typing

* **Dictate:** click the microphone (full-page chat only). Speak for up to 3 minutes, then click **Stop and transcribe** to put the text in the message box, or **Send voice message** to send it straight away. **Cancel voice input** throws the recording away. Your browser will ask for microphone permission the first time.
* **Voice mode:** click **Voice** to have a live spoken conversation with Connie. It can use the same tools as in text chat. Until you've sent something once, each thing you say is shown with **Send** / **Discard** so you can confirm Connie heard you right. Use **Mute microphone** to pause, and **End voice mode** (or **Esc**) to stop. Voice mode uses credits while the session is live.

Voice mode is unavailable while Connie is still replying, or while a teammate is using a shared chat.

## Stop, edit, retry and give feedback

* **Stop a reply:** while Connie is working, **Send** becomes **Stop**. Click it or press **Esc**. A stopped reply shows "Response was interrupted" with **Try again** and **Edit**.
* **Edit a message you sent:** hover the message and click **Edit**, change it, then click **Send** (or press ⌘/Ctrl+Enter). If later messages exist, Connie asks "Remove the later messages?". Choosing **Send and remove** deletes everything after that message for good.
* **Copy a reply:** click **Copy message**.
* **Rate a reply:** click **Helpful** or **Not helpful**. "Not helpful" asks "What went wrong?" (**Wrong or made up**, **Didn't do what I asked**, **Missing details**, **Unexpected action**, **Other**) with an optional note. This helps us improve Connie.

### Queue messages while Connie is working

Anything you send while Connie is replying waits above the box as "Queued: …". You can edit or remove a queued message, or drag it to change the order. If a message fails, it shows "Not sent: …" with **Retry**. If your last message didn't go through, the queue pauses ("Paused: your last message didn't go through.") until you click **Send now** or retry it.

## Ask Connie in a side panel (AI Copilot)

The **AI Copilot** panel lets you chat with Connie without leaving the page you're on, for example while looking at a list or building a workflow.

**Where:** the **Ask Connie** button at the top of a Records list or object, the workflow builder, and [Analytics](/analytics/overview).

* The panel header has **Recent chats** (pick an earlier chat), **New chat**, **Open full screen** (moves the same chat to the full Chat page) and **Close**.
* Drag the panel's edge to resize it. Double-click the edge to reset its width.
* Opening the panel picks up your last chat if you used it in the last 20 minutes. Otherwise it starts a new chat.
* In the panel, artifacts open on their own page instead of beside the chat; the panel stays open.
* The panel is not available on the full Chat page or in Settings.

## Find and manage your chats

**Recent chats** in the left sidebar lists your chats, newest activity first. It shows only when you're on **Chat**, **Tools** or **Skills**. Scroll or click **Load more chats** to see older ones.

* **Search:** click the search icon next to **Recent chats** and type in **Search conversations...**.
* **Pin:** drag a chat into **Pinned** at the top, or click the chat title → **Pin**. You can pin up to 8 chats and drag to reorder them. Keyboard: ⌘/Ctrl+↑ pins, ⌘/Ctrl+↓ unpins, ⌘/Ctrl+Shift+↑/↓ reorders.
* **All chats:** click **Chats** in the breadcrumb at the top of any chat to open the full list, with **My chats** and **Shared with me** tabs, search, and bulk **Star** / **Delete**. Starring a chat there is the same as pinning it. Chats opened from this list open in the side panel; use **Open full screen** to move them to the full page.

### Chat title menu

Click the chat title at the top of a full-page chat:

| Option | What it does |
| - | - |
| **Pin** / **Unpin** | Keeps the chat at the top of the sidebar |
| **Rename** | Edit the title inline. **Enter** saves, **Esc** cancels |
| **Duplicate** | Makes a copy of the chat |
| **Export** | Downloads the chat as a Markdown (`.md`) file, with your messages and Connie's replies |
| **Delete** | Permanently deletes the chat, its messages and attachments |

The other buttons at the top right are **Chat details** (the chat's [scheduled tasks](/automations/scheduled-tasks), follow-ups and [artifacts](/chat/sharing-and-artifacts)) and **Share** (see [Share a chat](/chat/sharing-and-artifacts)). They appear once the chat has its first message.

<Warning>
  Deleting a chat can't be undone. It also deletes the pages Connie created in it and turns off the share links for its pages and files. Apps Connie built in the chat are kept.
</Warning>

## Credits

Every message uses [credits](/billing/credits).

* Connie charges for each AI step it takes, based on how much text it reads and writes, with a minimum of 1 credit per step. One message can take several steps, and long chats cost more per message because Connie rereads the conversation.
* Tools that cost credits (for example enrichment or Lead Finder) are charged on top. Connie asks before running them; see [Approvals in chat](/chat/approvals). If a paid tool fails, its credits are refunded.
* Credits are set aside when a message starts and anything unused is given back. In **Settings** → **Logs**, chat replies show as "Generated AI response" and returned credits as "Credits refunded · unused reservation".
* Connie picks the AI model for you. There's no model picker.

When the workspace balance is 0 or below, new messages are refused with "Your credit balance is depleted. Go to Settings → Billing to continue." Add credits or upgrade (see [Top-ups](/billing/top-ups) and [Plans](/billing/plans)), then click **Try again**.

## Good to know

* **Who can chat:** workspace owners, admins and members. Guests can't run chat messages. See [Members and roles](/workspace/members-and-roles).
* **Only the chat's owner** can pin, rename, delete or change sharing. People a chat is shared with can chat in it, duplicate it and export it.
* **Not signed in:** visitors who aren't signed in get one free message, without tools ("Tools require an account. Sign in or create a free account to continue.").
* **Limits:**

| Limit | Value |
| - | - |
| Message length | 50,000 characters |
| Tool runs per chat | 200, then start a new chat |
| Chat history Connie reads | The last 100 messages (older ones are still shown, just not reread) |
| AI requests running at once per workspace | 20 |
| Messages per minute / per hour (Free plan) | 10 / 100. Starter allows 3× as many, Scale 10× |
| Attachments | 10 per message, 50 MB each, PDFs under 32 MB |
| Dictation | 3 minutes per recording |
| Pinned chats | 8 |

* A link like `https://connie.ai/<workspace-id>/chat?prompt=...` fills the message box but doesn't send it. Press **Send** yourself.
* Connie remembers your stable preferences across private chats. See [Memory](/chat/memory).

## Troubleshooting

<AccordionGroup>
  <Accordion title="Your credit balance is depleted. Go to Settings → Billing to continue.">
    **Why:** the workspace has no credits left. **Fix:** an owner or admin adds credits or upgrades in **Settings** → **Billing** (see [Top-ups](/billing/top-ups)). Then click **Try again** on the message.
  </Accordion>

  <Accordion title="Insufficient credits to run this tool. Please top up and try again.">
    **Why:** there were enough credits to start the reply, but not enough for a paid tool partway through. **Fix:** add credits, then ask Connie to continue.
  </Accordion>

  <Accordion title="You've reached your usage limit. Please wait a moment before trying again, or check your plan in Settings.">
    **Why:** you sent more messages than your plan allows in a short time. **Fix:** wait a minute and try again. Paid plans have higher limits; see [Plans](/billing/plans).
  </Accordion>

  <Accordion title="This conversation has reached its tool-call limit">
    **Why:** a single chat can run up to 200 tools. **Fix:** click **Start new chat** and carry on there. A fresh chat also works better, because very long chats lose context.
  </Accordion>

  <Accordion title="This conversation has grown too large to continue">
    **Why:** the chat history is too big. **Fix:** start a new chat. The old one stays readable.
  </Accordion>

  <Accordion title="Message too long (N characters). The limit is 50,000 characters.">
    **Why:** your message is over 50,000 characters. Your draft is kept. **Fix:** shorten it, or save the text as a file and attach it instead.
  </Accordion>

  <Accordion title="This workspace already has N AI requests in flight">
    **Why:** 20 AI requests are already running in your workspace (yours and teammates'). **Fix:** wait for some to finish, then send again.
  </Accordion>

  <Accordion title="Send is disabled and it says someone is typing or responding">
    **Why:** in a shared chat, only one person's message runs at a time. You may also see "This chat is busy — another member's turn is in progress. Wait for it to finish, then send your message." **Fix:** wait for your teammate's reply to finish. Your text is kept.
  </Accordion>

  <Accordion title="Replying in another tab">
    **Why:** the same chat is running in another browser tab. **Fix:** let it finish there, or close the other tab.
  </Accordion>

  <Accordion title="This chat is waiting for you to approve or reject the pending action.">
    **Why:** Connie is waiting on an approval card. **Fix:** scroll up and answer the card. See [Approvals in chat](/chat/approvals).
  </Accordion>

  <Accordion title="I couldn't confirm this request started">
    **Why:** a network hiccup or slow start. The message may still be running. **Fix:** wait a moment for the answer to appear. Send it again only if nothing shows up.
  </Accordion>

  <Accordion title="That message reached the model once and could not be safely retried">
    **Why:** Connie didn't retry automatically, to avoid charging you twice. **Fix:** send the message again.
  </Accordion>

  <Accordion title="Stop didn't seem to work">
    **Why:** the stop request couldn't be confirmed ("The server did not confirm the stop..." or "Could not confirm the stop. Check your connection; the turn may still be running."). **Fix:** check your connection and wait. The reply may still finish.
  </Accordion>

  <Accordion title="A file won't attach">
    **Why:** the type isn't supported, it's over 50 MB (PDFs: 32 MB), it's an old `.xls` file, it's already attached, or you've added 10 files. **Fix:** convert it (for example `.xls` to `.xlsx`), compress or split it, or send it in a separate message. If you see "Upload failed. Remove this file and try again.", remove it and attach it again.
  </Accordion>

  <Accordion title="Voice input is not available in this browser">
    **Why:** your browser can't record audio, or no microphone is found or allowed. **Fix:** use a recent Chrome or Edge, connect a microphone, and allow microphone access for connie.ai in your browser's site settings.
  </Accordion>

  <Accordion title="No speech detected">
    **Why:** the recording was silent. **Fix:** check the right microphone is selected and try again, or type your message.
  </Accordion>

  <Accordion title="Pin, Rename or Delete is greyed out">
    **Why:** only the person who started the chat can change it. **Fix:** ask the chat's owner.
  </Accordion>

  <Accordion title="Recent chats is missing from the sidebar">
    **Why:** it only shows on the Chat, Tools and Skills pages. **Fix:** click **Chat**.
  </Accordion>

  <Accordion title="Ask Connie opened a new or different chat">
    **Why:** the panel only resumes your last chat if you used it in the last 20 minutes. **Fix:** pick the chat from **Recent chats** in the panel header.
  </Accordion>

  <Accordion title="A link to the chats list takes me to the home page">
    **Why:** the full chats list only opens from inside a chat. **Fix:** open any chat and click **Chats** in the breadcrumb.
  </Accordion>
</AccordionGroup>

## Related

* [Approvals in chat](/chat/approvals) — why Connie stops to ask and what each button does
* [Sharing and artifacts](/chat/sharing-and-artifacts) — share a chat, and the pages, files and apps Connie makes
* [Memory](/chat/memory) — what Connie remembers about you
* [Scheduled tasks](/automations/scheduled-tasks) — have a chat run on a schedule
* [Skills](/skills/overview) — reusable instructions you can call with `/`
* [Tool permissions](/tools/permissions) — choose what Connie may run without asking
* [Credits](/billing/credits) — how credits work


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.