readme: document agent API