Ask GC AI a grounded question
Answer a legal question using the user's GC AI knowledge base so the response is grounded in their own material, not general model knowledge.
Steps
-
Bring in any referenced documents first. If the question is about a specific file the user attached, upload it (
upload_file, orstart_file_uploadplusfinish_file_uploadfor a sandbox file) and pollget_files({ id })untilready. If the question is about material already in GC AI, locate it withget_files,get_projects, orget_playbooksas needed. -
Ask. Call
ask_gcaiwith the question, scoping it to the relevant files or project when there is one. It is a long-running job: pollask_gcai_statusuntilstatusissucceeded,failed, orcanceled. -
Present the answer. Return the grounded answer with its citations to the underlying documents. Do not add legal conclusions the source material does not support.
-
Offer to keep it. If the user wants a record of the exchange in their GC AI history, call
ask_gcai_save_chat. Only save when the user asks; it writes to their account.
Notes
- Prefer grounding over recall. If the knowledge base has nothing relevant, say so plainly instead of answering from general knowledge.
- Complete the whole chain in one turn. Poll jobs yourself; never ask the user to wait.


