bcquality/community/knowledge/agents/use-documented-instruction-keywords.md
Jesper Schulz-Wedde b6da405376 Improve partner onboarding and documentation navigation
Lead with a complete plugin quick start and add task-oriented usage, troubleshooting, customization, and contribution guides. Preserve the broader plugin framing, correct conflicting contract guidance, support Agents folder reviews, and align repository validation. Convert existing sample references to clickable links without changing knowledge rules.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
2026-09-09 17:25:29 +02:00

1.5 KiB

bc-version domain keywords technologies countries application-area
27..
agents
instruction-keywords
request-a-review
memorize
write-an-email
invoke-action
al
w1
all

Use the toolkit instruction keywords for review, mail, and memory

Description

The agent runtime looks for specific phrases: ask for assistance, request a review, reply, write an email, memorize, Set field, use lookup, Invoke action. Ordinary English such as get a human to look or remember this is weaker. Outbound reply and email always require review; that is platform policy, not optional tone.

Best Practice

In the instruction resource, use those keywords at the decision points: request a review before posting; write an email only after stating that outbound mail is reviewed; memorize values the later steps need. Pair Reply / Write an email with an explicit review sentence.

See sample: use-documented-instruction-keywords.good.al.

Anti Pattern

Inventing tool-like verbs (call Copilot, click Post_Promoted) or omitting request a review before posting. Detection signal: instruction text that says email the customer with no review keyword.

See sample: use-documented-instruction-keywords.bad.al.

See also

instruction-structure-is-role-rules-steps.md defines the containing document structure, while instructions-describe-work-not-tool-ids.md keeps outcomes independent of UI tool identifiers.