What goes in an approval request: a short reason or a link to the trace?
A reader left a comment on the approval queue post: should the request carry a short justification inline, or just link to the trace? Short answer: both, but they do different jobs, and they should never be mixed together in one block of text. Here is how we lay it out. § 01 · Two ways an approval request goes wrong ◆ Link only. The reviewer has to open a trace, scroll through tool calls and work…
Approval requests require both a concise reason and a link to the trace, but these should not be combined in one block of text. The request should consist of three parts: facts calculated by the system, the agent's short reason, and a link to the trace for cases where the facts and reason do not match or appear unusual. Each request should also display its deadline and the consequences of no response. The layout and presentation of this information is crucial to ensure effective and safe approval processes.
Written by urgent.news from Dev.to's reporting — not their text. Machine-written — may contain errors; check the original before relying on it.