Carry the state

​

Keep one state per conversation

1. On the first call, send an empty string as state.
2. After each response, keep its state in place of the old one.
3. On the next call, send that state, copied exactly. Send that field only, never the whole response.
4. To start a new conversation, send an empty string again.

states = {}  # the last state of each conversation


def turn(conversation_id, request, position=None):
    """request: the fields your agent's model wrote, such as {"request": "search", "kind": "cafe"}."""
    body = {**request, "state": states.get(conversation_id, "")}
    if position is not None:
        body["anchor"] = position
    data = call_kviria(body)  # POST /v1/agent, with your Kviria key
    states[conversation_id] = data.get("state", body["state"])
    return data

​

After an error

• 400 invalid_state: the state was altered. The body carries an empty state. Keep it, and the conversation starts again.
• 400 with invalid_body, invalid_request, unsupported_field, transcript_removed or anchor_required: the body carries a state. Keep it and send it on the next call.
• Every other error carries no state. Keep the one you had.

​

Send the position

• Send anchor on the first call. Kviria keeps it in the state.
• After that, send anchor only when the user moves. A call without one uses the position in the state.
• Send the user’s position exactly as you were given it. Never send the coordinate of a place from an answer as the user’s position. Kviria keeps the earlier position when it sees one, and the evidence says so.