kris/afv-library
1
0
Fork 0
mirror of https://github.com/forcedotcom/afv-library.git synced 2026-07-30 11:43:26 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

Update skills/developing-agentforce/references/agent-user-setup.md

Browse Source 
Co-authored-by: Steve Hetzel <shetzel@salesforce.com>
This commit is contained in:
npiccolo 2026-05-07 15:01:40 -03:00 committed by GitHub
parent 23f2caa9e7
commit 93a47c7948
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 2 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
skills/developing-agentforce/references/agent-user-setup.md
View File

@ -94,7 +94,8 @@ sf agent activate --json \
Critical notes:
- `sf org create agent-user` works in **all org types** (scratch, sandbox, production) — use it instead of the legacy `sf org create user` or `sf data create record` approach
- The command auto-assigns `AgentforceServiceAgentUser` — no separate permset assignment needed
- The command auto-assigns `AgentforceServiceAgentBase`, `AgentforceServiceAgentUser`, and `EinsteinGPTPromptTemplateUser` — no separate permset assignment needed
- The command may exit non-zero with `PermissionSetAssignmentError` if a permset license is exhausted, **even when the user was created successfully**. Always inspect `result.username` and `result.permissionSetErrors[]` from the JSON output. If the only failure is `EinsteinGPTPromptTemplateUser` and your agent has no Prompt Template actions, you can proceed. Otherwise, free a license (or use `--base-username` to retry against a different license pool) before continuing.
- Capture the generated username from the command output (`result.username`) and use it for `default_agent_user`
- Always test with preview BEFORE publishing to avoid version management overhead
- Assign any custom permission sets (`{AgentName}_Access`) BEFORE publishing to prevent "Internal Error"