mirror of
https://github.com/forcedotcom/afv-library.git
synced 2026-08-09 08:53:18 +08:00
4848ecc844
Three findings from wiring an Agent Script service agent to an apex://
invocable (API v67.0, sf CLI 2.145.6):
1. `sf agent validate authoring-bundle` returns success:true for an action
param with the wrong numeric type. Only the server-side check during the
publish step catches it, so a green validate is not evidence the action
I/O types are correct.
2. Apex Integer and Apex Decimal do not behave the same. An Integer param
as bare `number` is rejected at publish; a Decimal output as bare
`number` publishes and runs correctly. The existing "bare number fails
at publish in action inputs/outputs" note reads as universal, which
sends authors hunting for a complex type a Decimal does not need.
3. Preview started with --api-name writes trace files containing only {}.
Only the --authoring-bundle path produces readable traces. This is not
academic: a service agent cannot always be previewed via
--authoring-bundle, leaving --api-name as the only option and making the
"read the trace after every utterance" rule unsatisfiable. Documented a
discriminating-value fallback for that case.
All additive; no existing guidance removed.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
||
|---|---|---|
| .. | ||
| action-prompt-templates.md | ||
| actions-reference.md | ||
| agent-access-guide.md | ||
| agent-design-and-spec-creation.md | ||
| agent-metadata-and-lifecycle.md | ||
| agent-script-core-language.md | ||
| agent-subagent-map-diagrams.md | ||
| agent-user-setup.md | ||
| agent-validation-and-debugging.md | ||
| architecture-patterns.md | ||
| complex-data-types.md | ||
| data-library-reference.md | ||
| deploy-reference.md | ||
| discover-reference.md | ||
| examples.md | ||
| feature-validity.md | ||
| instruction-resolution.md | ||
| known-issues.md | ||
| mcp-management-reference.md | ||
| optimization-pattern-1-data-flow.md | ||
| optimization-pattern-2-deterministic-logic.md | ||
| optimization-pattern-3-reference-syntax.md | ||
| optimization-pattern-4-escalation.md | ||
| org-setup-for-adl.md | ||
| patterns-by-requirement.md | ||
| posture-and-determinism.md | ||
| production-gotchas.md | ||
| reference-map.md | ||
| safety-review-reference.md | ||
| salesforce-cli-for-agents.md | ||
| scaffold-reference.md | ||
| scoring-rubric.md | ||
| version-history.md | ||
| voice-latency-heuristics.md | ||
| voice-modality-reference.md | ||
| zen-of-agentscript.md | ||