Feedback System

Feedback on recall answers is handled via Sessions: you record Q&A in a session, then attach feedback to specific entries using cognee.session.add_feedback and cognee.session.delete_feedback. Before you start:

Complete Quickstart and Sessions
Run recall() with a session_id so that Q&A entries are stored
Ensure caching is enabled

Record feedback on a session Q&A

Run recall() with session_id so the interaction is stored.
Get the session history with cognee.session.get_session and identify the qa_id of the entry you want to rate.
Call cognee.session.add_feedback with that qa_id, and optionally feedback_text and feedback_score (1–5).
To make feedback influence future retrieval, run improve() with the relevant session_ids. If you are already writing new content with remember(), self_improvement=True can trigger this in the background automatically.
To clear feedback, use cognee.session.delete_feedback(session_id=..., qa_id=...). Both add_feedback and delete_feedback return True on success, False if the entry was not found or the cache is unavailable.

get_session returns a list of SessionQAEntry objects. Each entry has: qa_id, question, answer, context, time, feedback_text, feedback_score. Entries are in chronological order (oldest first); use entries[-1] for the most recent. Pass optional user for multi-tenant or permission-scoped usage.

import cognee
from cognee import SearchType

# Run recall with a session so the Q&A is stored
results = await cognee.recall(
    query_text="What are the main themes in my data?",
    query_type=SearchType.GRAPH_COMPLETION,
    session_id="my_session",
)
print(results)

# Get session history; entries are chronological, so latest is entries[-1]
entries = await cognee.session.get_session(session_id="my_session", last_n=5)
latest = entries[-1]
qa_id = latest.qa_id

# Add feedback for that Q&A (feedback_score must be 1–5)
ok = await cognee.session.add_feedback(
    session_id="my_session",
    qa_id=qa_id,
    feedback_text="Very helpful and accurate",
    feedback_score=5,
)
# ok is True if the entry was found and updated

# Push feedback into the graph
await cognee.improve(
    dataset="main_dataset",
    session_ids=["my_session"],
)

# Recall again with feedback_influence > 0 to surface the weighted results
improved_results = await cognee.recall(
    query_text="What are the main themes in my data?",
    query_type=SearchType.GRAPH_COMPLETION,
    feedback_influence=0.5,
)
print(improved_results)

The per-call feedback_influence defaults to the DEFAULT_FEEDBACK_INFLUENCE environment variable, which is 0.0 (off) by default — so the learned feedback signal does not change ranking until you opt in. Set DEFAULT_FEEDBACK_INFLUENCE (e.g. 0.1) to activate the signal globally, or pass feedback_influence per call to recall() / search() to override it. Setting it back to 0.0 restores the prior baseline.

Feedback API Reference

`add_feedback()`

Attach a rating and optional text comment to a stored Q&A entry.

Parameter	Type	Description
`session_id`	`str`	Target session that contains the Q&A entry.
`qa_id`	`str`	Target entry ID. You can get this value from `entry.qa_id` on a `SessionQAEntry` returned by `get_session()`.
`feedback_text`	`Optional[str]`	Optional free-form feedback comment.
`feedback_score`	`Optional[int]`	Optional integer rating from `1` to `5`.
`user`	`Optional[User]`	Optional session owner; resolves automatically when `None`.

Returns True if feedback was stored successfully, False if the entry was not found or the cache is unavailable.

`delete_feedback()`

Clear both feedback_text and feedback_score for an existing Q&A entry without deleting the entry itself.

Parameter	Type	Description
`session_id`	`str`	Target session that contains the Q&A entry.
`qa_id`	`str`	Target entry ID whose feedback should be cleared.
`user`	`Optional[User]`	Optional session owner; resolves automatically when `None`.

Returns True if feedback was cleared, False if the entry was not found or the cache is unavailable. When calling add_feedback(), provide at least one of feedback_text or feedback_score. If you pass feedback_score, it must be an integer between 1 and 5.

Example

cleared = await cognee.session.delete_feedback(
    session_id="my_session",
    qa_id="some-qa-id",
)
print("Feedback cleared:", cleared)

Sessions

Enable conversation memory with sessions

Sessions and Caching

How sessions and caching work

Improve

Enrich the graph and bridge session memory

Getting Started

Core Concepts

Setup Configuration

Guides

Examples

CLI

Rust SDK

TypeScript SDK

OSS

Record feedback on a session Q&A

Feedback API Reference

`add_feedback()`

`delete_feedback()`

Example

Sessions

Sessions and Caching

Improve

​Record feedback on a session Q&A

​Feedback API Reference

​add_feedback()

​delete_feedback()

​Example

Sessions

Sessions and Caching

Improve

Record feedback on a session Q&A

Feedback API Reference

`add_feedback()`

`delete_feedback()`

Example