added docs/api/agent.md