bcquality/community/knowledge/agents/skip-incoming-review-only-for-trusted-input.md
Jesper Schulz-Wedde 2b5550c346
Some checks failed
Validate knowledge index / validate-index (push) Has been cancelled
Validate AL review fixtures / validate-review-fixtures (push) Has been cancelled
Validate frontmatter and structure / validate (push) Has been cancelled
Improve partner onboarding and documentation navigation (#174)
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: Jesper Schulz-Wedde <jesper.schulzwedde@microsoft.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
2026-09-09 17:31:03 +02:00

1.3 KiB

bc-version domain keywords technologies countries application-area
28..
agents
setrequiresreview
agent-task-message-builder
approval
trusted-input
skip-review
al
w1
all

Skip incoming message review only after the caller validated the payload

Description

Incoming task messages default to requiring user approval before the agent runs. From 28.1, Agent Task Message Builder.SetRequiresReview(false) starts the agent immediately. That is safe only for inputs you already validated in AL (your page action, your posting subscriber). External email or partner payloads are not trusted by default. Analysis Warnings still force a review.

Best Practice

Leave the default review-on for anything that originated outside your extension. Call SetRequiresReview(false) only on messages you constructed from already-authorized BC data.

See sample: skip-incoming-review-only-for-trusted-input.good.al.

Anti Pattern

SetRequiresReview(false) on simulated email, incoming webhooks, or user-free text. Detection signal: SetRequiresReview(false) next to external content with no prior validation.

See sample: skip-incoming-review-only-for-trusted-input.bad.al.