# Agent settings

Bito's [AI Code Review Agent](/ai-code-reviews-in-git/overview.md) supports different configuration methods depending on the deployment environment:

1. **Bito-hosted** – The agent runs on Bito's infrastructure and is configured through the [Bito web UI](https://alpha.bito.ai/).
2. **Self-hosted** – The agent runs on user-managed infrastructure and is configured by editing the [`bito-cra.properties` file](/ai-code-reviews-in-git/install-run-as-a-self-hosted-service/agent-configuration-bito-cra.properties-file.md).

The sections below provide configuration guidance for each setup.

## Bito-hosted agent configuration

In Bito-hosted AI Code Review Agent, you can configure the agent through the [Bito web UI](https://alpha.bito.ai/).

To customize an existing agent, open the [**Code Review > Repositories**](https://alpha.bito.ai/home/ai-agents/code-review-agent) page and click the **Settings** button next to the Agent instance to be modified.

The agent settings page allows configuration of options such as:

* **Agent name** – Define a unique name for easy identification.
* **Review options** – Choose the review mode (Essential or Comprehensive), set feedback language, and enable features like auto-review, incremental review, summaries, and change walkthroughs.
* **Custom guidelines** – Create and apply custom code review rules tailored to your team’s standards directly from the dashboard.
* **Filters** – Exclude specific files, folders, or branches from review to focus on relevant code.
* **Tools** – Enable additional checks, such as secret scanning and static analysis.
* **Chat** – Configure how the agent responds to follow-up questions in pull request comments and manage automatic replies.

These settings tailor the agent’s behavior to match team workflows and project needs. For detailed guidance, see [Create or customize an Agent instance](https://docs.bito.ai/ai-code-review-agent/install-run-using-bito-cloud/create-or-customize-an-agent-instance).

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><mark style="color:blue;"><strong>Learn more</strong></mark></td><td><a href="/pages/c2rnX1WC7HSmQdYRsJvG">/pages/c2rnX1WC7HSmQdYRsJvG</a></td></tr></tbody></table>

{% embed url="<https://youtu.be/Oj4A8wd1bio>" %}

## Self-hosted agent configuration

In self-hosted deployments, configuration is managed by editing the [`bito-cra.properties` file](/ai-code-reviews-in-git/install-run-as-a-self-hosted-service/agent-configuration-bito-cra.properties-file.md). This file defines how the agent operates and connects to required services.

Key configuration options include:

* **Mode**
  * `mode = cli`: Processes a single pull request using a manual URL input.
  * `mode = server`: Runs as a webhook service and listens for incoming events from Git platforms.
* **Authentication**
  * `bito_cli.bito.access_key`: Required for authenticating the agent with the Bito platform.
  * `git.provider`, `git.access_token`, etc.: Required for connecting to the appropriate Git provider (e.g., GitHub, GitLab, Bitbucket).
* **General feedback settings**
  * `code_feedback`: Enables or disables general feedback comments in reviews.
* **Analysis tools**
  * `static_analysis`: Enables static code analysis.
  * `dependency_check`: Enables open-source dependency scanning.
  * `dependency_check.snyk_auth_token`: Required when using Snyk for vulnerability detection.
* **Review format and scope**
  * `review_comments`: Defines output style (e.g., single post or inline comments).
  * `review_scope`: Limits the review focus to specific concerns such as security, performance, or style.
* **Filters**
  * `include_source_branches` and `include_target_branches`: Restrict reviews to pull requests that match specified source and target branch patterns.
  * `exclude_files`: Skips selected files based on glob patterns.
  * `exclude_draft_pr`: Skips draft pull requests when enabled (default: `True`).

Each property is documented in detail on the [bito-cra.properties file documentation](/ai-code-reviews-in-git/install-run-as-a-self-hosted-service/agent-configuration-bito-cra.properties-file.md) page.

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><mark style="color:blue;"><strong>Learn more</strong></mark></td><td><a href="/pages/HamLQyyKbZ4MSqX5EskI">/pages/HamLQyyKbZ4MSqX5EskI</a></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bito.ai/ai-code-reviews-in-git/agent-settings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.