Clarify types for activityId and agent properties in document APIs

Fixes issue #507 

Applies similar logic to the agent property and standardizes the typer used. 

Removes an errant > in the markdown.