The Chat API

Day 4 Lab

1. Send a question to the Chat API as a single user message.
2. Read the answer text from the response fragments.
3. Pull the citations and list the documents the answer rests on.
4. Treat an answer with no citations as ungrounded — verify before you act on it.

Working Example: Read the Citations

The Chat API grounds its answer in your content and returns the citations that back it. Always read those citations — they are how you measure whether the answer is trustworthy. Verified against api_clients.

import os
from glean import Glean

client = Glean(
    instance=os.environ["GLEAN_INSTANCE"],
    api_token=os.environ["GLEAN_API_TOKEN"],
    actas_user=os.environ["END_USER_EMAIL"],
)

response = client.client.chat.create(
    messages=[
        {"author": "USER", "fragments": [{"text": "What is our PTO carryover policy?"}]}
    ],
)

answer = response.messages[-1]
print("Answer:", "".join(f.text for f in answer.fragments if f.text))

# The citations are the grounding — no citations means no trustworthy source.
for c in answer.citations or []:
    doc = c.source_document
    print("Cited:", doc.title, "->", doc.url)

If citations is empty, the answer is ungrounded — surface that to the user rather than presenting it as fact. Verified against api_clients.