> ## Documentation Index
> Fetch the complete documentation index at: https://docs.circuit.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Providing feedback

> How to use the thumbs up and thumbs down buttons to help improve Circuit's answers over time.

Every response from a Circuit agent includes feedback buttons. Your feedback is one of the most valuable inputs for improving the system.

## How it works

Each agent response has two buttons:

* **Thumbs up**: the answer was helpful and accurate
* **Thumbs down**: the answer was unhelpful, inaccurate, or incomplete

When you click either button, you can optionally add a text comment explaining your rating.

## Why your feedback matters

Your feedback goes directly to your administrators and the Circuit engineering team. It's used to:

* **Identify knowledge gaps**: if agents frequently can't answer certain types of questions, it signals that more documents need to be added to the relevant indexes
* **Improve agent configuration**: feedback patterns help administrators fine-tune which indexes an agent searches and how it's configured
* **Enhance the product**: the Circuit team uses aggregate feedback to improve the AI's reasoning, citation accuracy, and response quality

Every piece of feedback, positive or negative, contributes to making Circuit work better for your entire workspace.

## What makes good feedback

<Tabs>
  <Tab title="Thumbs up">
    Click thumbs up when:

    * The answer was accurate and well-sourced
    * The citations pointed to the right documents
    * The response format was useful (good structure, appropriate detail level)

    Optional comment examples:

    * "Exactly what I needed, with the right part numbers"
    * "Good summary of the installation steps"
  </Tab>

  <Tab title="Thumbs down">
    Click thumbs down when:

    * The answer was factually incorrect
    * The agent couldn't find information you know exists in the system
    * The response was too vague or too detailed for your needs
    * The citations referenced outdated or wrong documents

    Optional comment examples:

    * "The pressure rating listed is for the old model, not the current one"
    * "This information is in the 2024 product catalog but the agent didn't find it"
    * "I asked about Model A but got specs for Model B"
  </Tab>
</Tabs>

## Additional feedback options

When you provide feedback, you may also be able to:

* **Share the chat**: consent to share the full chat history for review, which gives the team complete context
* **Suggest the correct answer**: if you know the right answer, include it so the team can understand what went wrong
* **Reference specific documents**: point to the document or page that should have been cited

<Note>
  Feedback is reviewed by your workspace's administrators. It's used constructively to improve the system, never to evaluate individual users.
</Note>