⌘ K

Search

Search portal content

AI customer support in one tabAI customer support in one tab
⌘ K

Search

Search portal content

AI customer support in one tabAI customer support in one tab
  • How AI works
  • Write agent instructions
  • Use AI drafts
  • Auto-tag tickets
  • Improve AI answers
  1. Home
  2. AI & Knowledge

Write agent instructions

Write the Skill that tells initdesk's AI how to reply: your tone, what to avoid, and what to ask for. It shapes every AI draft you create.

On this page
  • Write agent instructions
  • Open the Skill
  • Write the Skill
  • Save your changes
  • How the Skill is used
  • What the Skill doesn't change
  • If something's not working
  • If drafts still sound generic
  • If you see "The skill cannot be empty."
  • If you see "The skill must be at most 100,000 characters."
  • If you see "We could not save the skill right now. Please try again later."
  • Related

Write agent instructions

Write the Skill that tells initdesk's AI how to reply: your tone, what to avoid, and what to ask for. It shapes every AI draft you create.

The Skill is a set of instructions you write once. initdesk's AI reads it every time it drafts a reply to a ticket, so drafts sound like your team: your greeting, your level of formality, the things you never say.

Open the Skill

  1. In the left sidebar, open AI & Knowledge.
  2. Select Agent instructions.

Your organization already has a Skill. initdesk writes a first one when you create the organization. If you gave your website address, it reads your site to match your brand and product. If you didn't, it starts from a short, general support script. Either way, edit it so it fits how you write.

Write the Skill

The editor has two views, Text and Markdown. Both edit the same document. Use Text for everyday writing. Use Markdown if you want to see or paste the raw characters. Switching never loses an edit.

The field starts with a prompt: write how the agent should answer, what it must never do, and when to hand off to a person.

A Skill that works well covers:

  • Tone. How formal you are, how warm, how long your replies run.
  • Greeting and sign-off. The exact words you use to open and close.
  • Things to avoid. Promises you don't make, topics you don't discuss by email, words you don't use.
  • What to ask for. The details you need before you can help, such as an order number or the plan name.

Keep it concrete. "Friendly" does little. "Greet the customer by first name, keep replies under 120 words, and never promise a refund date" gives the AI something to follow.

The Agent instructions page showing the Skill editor with the Text and Markdown switch
The Skill is one document. Switch between Text and Markdown at any time.

Save your changes

  1. Select Save.
  2. Wait for the confirmation. It starts with "Saved."

Your next draft uses the new Skill. Drafts you already created don't change.

The Skill can't be empty, and it can be up to 100,000 characters. If you leave the page with unsaved changes, initdesk asks whether to discard them.

How the Skill is used

The Skill applies to reply drafts. When you select Draft with AI in a ticket, the AI reads your Skill with the ticket, the customer's history, and your published articles. See Use AI drafts.

When instructions disagree, the AI follows them in this order:

  1. initdesk's built-in rules, such as writing only the reply text and keeping internal information out of it.
  2. The guidance you type for one draft in the Draft with AI box.
  3. Your Skill.

So guidance for one draft wins over the Skill, and the Skill can't turn off a built-in rule.

What the Skill doesn't change

  • The help center chat. The chat on your help center and on your site follows its own fixed rules and answers from your published articles. Writing "hand off billing questions to a person" in the Skill doesn't change what the chat does. To change chat answers, change your articles. See Improve AI answers.
  • Facts. The Skill sets voice and rules. It isn't where product facts should live. Put answers in help center articles, where the AI can find the right passage for each question and your customers can read the same words.
  • What gets sent. A draft is never sent for you. You review it, edit it, and send it.

If something's not working

If drafts still sound generic

The Skill is probably too general. Add real examples of an opening line and a closing line, and say what you never write. Then create a new draft and compare.

If you see "The skill cannot be empty."

You tried to save a blank Skill. Write at least one line, or reload the page to restore the saved version.

If you see "The skill must be at most 100,000 characters."

The Skill is too long. Cut it down. Move product facts into help center articles.

If you see "We could not save the skill right now. Please try again later."

Your change was not saved. Keep the page open, copy your text somewhere safe, and select Save again. If it keeps failing, open Help in the left sidebar and choose Send us a message.

Related

  • Use AI drafts
  • How AI works
  • Improve AI answers
How AI works

See where AI helps in initdesk, what it reads for each job, and what happens when it has no answer. AI drafts, a person sends.

Use AI drafts

Open a ticket, choose Draft with AI, then edit and send the reply it writes. Add guidance, refine the draft, or undo it.

Powered by initdesk