depending on how advanced this AI will be, it could learn from a few samples and the API docs, possibly itself designed to be optimally consumed by AI. If I knew that AI would consume my custom programming language docs then I would make sure that each API is used once in some kind of sample code so it can give answers to everything. Plus, that's a sensible thing to do anyway.