Resolve "Document how to customize the permissions for 'agentk'"

What does this MR do and why?

• Adds documentation on how the user can restrict the access rights for the agent
• Cleans up the documentation

Screenshots or screen recordings

These are strongly recommended to assist reviewers and reduce the time to merge your change.

How to set up and validate locally

Numbered steps to set up and validate the change are strongly suggested.

MR acceptance checklist

This checklist encourages us to confirm any changes have been analyzed to reduce risks in quality, performance, reliability, security, and maintainability.

• I have evaluated the MR acceptance checklist for this MR.

Related to #346726 (closed)