chore: sync main with staging

.env.example

@@ -39,7 +39,6 @@ GOOGLE_SERVICE_ACCOUNT=/app/credentials/chatbot-sa.json
 # ============================================================
 MODEL_URI=google_genai:gemini-2.5-flash
 MODEL_TEMPERATURE=0.2
-MAX_TOKENS=524288
 
 # ============================================================
 # ==                   LangSmith settings                   ==

Makefile

@@ -0,0 +1,10 @@
+.PHONY: up up-dev down
+
+up: # Start all services (with website api network)
+	docker compose up --build --watch
+
+up-dev: # Start in dev mode (no website api network)
+	docker compose -f compose.yaml up --build --watch
+
+down: # Stop all services
+	docker compose down

README.md

@@ -46,12 +46,13 @@ cp .env.example .env
 > [!IMPORTANT]
 > Você precisará de uma conta de serviço com acesso ao BigQuery e à VertexAI, chamada `chatbot-sa.json` e armazenada em `${HOME}/.basedosdados/credentials`.
 
-### 2. Modo de desenvolvimento independente
-Por padrão, a API do chatbot exige um token JWT válido emitido pela API do website. Para desenvolvimento local sem depender da API do website, habilite o modo de autenticação de desenvolvedor no arquivo `.env`:
+### 2. Modo de Autenticação de Desenvolvedor
+Por padrão, a API do chatbot depende da API do website para autenticação e autorização de usuários. Para desenvolvimento local sem depender da API do website, habilite o modo de autenticação de desenvolvedor no arquivo `.env`:
 ```bash
 AUTH_DEV_MODE=true
 AUTH_DEV_USER_ID=uuid
 ```
+
 > [!NOTE]
 > O modo de autenticação de desenvolvedor só funciona quando `ENVIRONMENT=development`.
 >
@@ -61,24 +62,20 @@ AUTH_DEV_USER_ID=uuid
 > O modo de autenticação de desenvolvedor ignora a validação do token JWT e retorna o ID definido por `AUTH_DEV_USER_ID` para todas as requisições. **Nunca habilite em produção.**
 
 ### 3. Executando a API
-**Com o [Compose Watch](https://docs.docker.com/compose/how-tos/file-watch/) (recomendado):**
+Os comandos abaixo executam a API do chatbot sem dependências externas. O modo de autenticação de desenvolvedor deve estar ativado para ignorar a autenticação e autorização de usuários.
+
+**Com o [Make](https://www.gnu.org/software/make/):**
 ```bash
-docker compose up --watch
+make up-dev
 ```
 
-**Manualmente com o uv:**
+**Com o [Compose Watch](https://docs.docker.com/compose/how-tos/file-watch/):**
 ```bash
-uv run alembic upgrade head
-uv run fastapi dev --host 0.0.0.0 app/main.py
+docker compose -f compose.yaml up --build --watch
 ```
-> [!NOTE]
-> Caso opte por executar a API manualmente, você precisará configurar uma instância do PostgreSQL ou executar o serviço `database` do compose file com `docker compose up database`.
-> Em ambos os casos,<br>ajuste as variáveis `DB_*` no `.env` conforme necessário para conectar-se ao banco.
->
-> Além disso, aponte a variável `GOOGLE_SERVICE_ACCOUNT` para o caminho local da conta de serviço.
 
 ## Executando a Aplicação Completa (Full Stack)
-Para testar a integração completa com o frontend e a API do website, siga as instruções abaixo.
+Para executar a integração completa com o frontend e a API do website, siga as instruções abaixo.
 
 ### 1. Configuração da API do website
 Clone o repositório do [backend](https://github.com/basedosdados/backend):
@@ -110,9 +107,14 @@ JWT_SECRET_KEY=jwt-secret-key
 > | `JWT_ALGORITHM` | `DJANGO_JWT_ALGORITHM` |
 > | `JWT_SECRET_KEY` | `DJANGO_SECRET_KEY` |
 
-Execute a API do chatbot:
+Execute a API do chatbot com o Make:
 ```bash
-docker compose up --watch
+make up
+```
+
+Ou com o Compose Watch:
+```bash
+docker compose up --build --watch
 ```
 
 ### 3. Configuração do frontend
@@ -123,3 +125,6 @@ cd chatbot-frontend
 ```
 
 Configure e execute de acordo com as [instruções do repositório](https://github.com/basedosdados/chatbot-frontend?tab=readme-ov-file#interface-do-chatbot-da-bd-feita-com-streamlit).
+
+> [!TIP]
+> Você também pode executar a aplicação full stack com o modo de autenticação de desenvolvedor ativo. Isso pode ser útil caso você deseje apontar a variável `BASEDOSDADOS_BASE_URL` para a api do website de produção. Porém, a autenticação e autorização de requisições à API do chatbot serão ignoradas nesse caso.

app/agent/__init__.py

@@ -1,3 +0,0 @@
-from .react_agent import ReActAgent
-
-__all__ = ["ReActAgent"]