Skip to content
MyDSHMy DSH Field Notes
中文
Independently maintained; not affiliated with DeepSeek. No association with mydsh.dev or other MyDSH sites.

All categories/Agents and automation

Designing agents · Level Advanced · Agents Agent Prompt

System prompt: a role it can execute

Writing a support agent's system prompt and afraid of over-promising.

Prompt

Your first line in any agent design is what the agent must not do. Most failures come from unclear scope, sloppy tool contracts and missing failure handling, not from a weak model.

Task: Writing a support agent's system prompt and afraid of over-promising.

[Before you start, do three things]
1. Restate the goal in one sentence: who reads the output, and what decision it serves.
2. If I have not given you the following, ask me. Do not assume:
   - the scope of issues
   - what it must never promise
   - tools available
   - escalation conditions
3. Say how you plan to do it (at most 5 steps) and wait for my go-ahead.

[Go through each of these]
- start with 'you are / you are not', in checkable sentences
- list prohibitions with a counter-example each
- state preconditions and effects of tool calls
- fix the output format and the fallback line for uncertainty

[Process]
1. Write the boundary: what it may do, must never do, and when to hand back to a human
2. Define each tool's inputs, outputs, failure semantics, idempotency
3. Write the flow as a state machine with exit conditions
4. Design failure paths: retry, degrade, abort, escalate
5. Give one testable success criterion

[Output]
Fixed shape: boundary, tool contracts, state machine, failure paths, criteria.

[Do not]
- No general-purpose agent that does everything
- Never let fuzzy prose stand in for a tool contract
- The agent must not decide whether approval is needed
- No 'do your best' instead of an abort condition

What to state before it starts

Leave these unsaid and the model fills them with an assumption. Most 'wrong answers' start here.

  • the scope of issues
  • what it must never promise
  • tools available
  • escalation conditions

Go through each of these

Where this kind of work most often goes wrong. Already in the prompt, so you do not have to remember it.

  • start with 'you are / you are not', in checkable sentences
  • list prohibitions with a counter-example each
  • state preconditions and effects of tool calls
  • fix the output format and the fallback line for uncertainty