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

# Tips and Tricks

> Tips and tricks for using Typewise

> [card] Write Specialists the way the AI reads them
>
> The "When to use" field is the only thing the AI reads when it picks a
> Specialist. See [Writing good
> Specialists](https://docs.typewise.app/guides/best-practices/writing-specialists.md) for what belongs in
> each field.

> [card] Link actions and knowledge explicitly
>
> Use `@Action: Name` and `@Knowledge: Name` in your Specialist instructions.
> This makes the AI more reliable than just describing them in prose.

> [card] Be specific with handoff conditions
>
> "Customer is frustrated" is better than "when appropriate". The more
> specific, the fewer surprises.

> [card] Test with the Simulator
>
> The [Simulator](https://docs.typewise.app/documentation/testing-and-feedback/simulator.md) works for
> chat, email, and WhatsApp. Use it to test a full conversation flow before
> making changes live.

> [card] Choose the right website lookup
>
> Use [import website](https://docs.typewise.app/documentation/knowledge/web/import-website.md) for stable
> content like FAQs. Use [live URL
> fetch](https://docs.typewise.app/documentation/knowledge/web/live-url-fetch.md) when you need dynamic
> URLs with parameters.

> [card] Use access levels correctly
>
> "No sharing allowed" lets the AI use info for reasoning but not quote it.
> "Internal use only" hides it from the AI Agent entirely.

> [card] Require human approval for sensitive actions
>
> Enable this on actions like refunds. The AI will still prepare everything,
> but a human confirms before execution.


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