Yet more docstring updates for agent api
Update schema docstring as well
Merge pull request #32 from guidow/agent_api_doc_fix

Yet more docstring updates for agent api