> For the complete documentation index, see [llms.txt](https://public-intelligence.gitbook.io/taina-agente-ia-ogtic/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://public-intelligence.gitbook.io/taina-agente-ia-ogtic/empezando-con-taina/quick-start.md).

# Guía rápida

Resumen ejecutivo para desplegar Taína Agente IA en menos de 10 minutos. Para instrucciones detalladas de cada paso, consulta la [guía de instalación completa](/taina-agente-ia-ogtic/empezando-con-taina/installation.md).

## Prerrequisitos

* Servidor con Ubuntu 22.04+ y Docker instalado ([ver preparación del servidor](/taina-agente-ia-ogtic/empezando-con-taina/prerrequisitos.md))
* Credenciales de: LiveKit, Google Gemini, Deepgram, ElevenLabs ([ver guía de credenciales](/taina-agente-ia-ogtic/empezando-con-taina/configuracion-entorno.md))
* Archivos `*_rag_documents.json` de la base de conocimiento ([ver guía de datos](/taina-agente-ia-ogtic/empezando-con-taina/base-conocimiento.md))

***

## 5 pasos para levantar Taína

### 1. Clonar el repositorio

```bash
git clone <url-del-repositorio> taina_ogtic
cd taina_ogtic
```

### 2. Configurar variables de entorno

```bash
cp backend/.env.example backend/.env
nano backend/.env
# Completa: LIVEKIT_URL, LIVEKIT_API_KEY, LIVEKIT_API_SECRET,
#           GOOGLE_API_KEY, DEEPGRAM_API_KEY,
#           ELEVENLABS_API_KEY, ELEVENLABS_VOICE_ID, CARTESIA_API_KEY
```

### 3. Colocar credenciales y poblar la base de conocimiento

```bash
# Credenciales GCP (si usas grabaciones)
cp /ruta/credencial.json backend/google_bucket_config.json

# Poblar la base de conocimiento (Opción A: desde la API oficial)
cd backend/
./setup_databases.sh --env produccion --build-qa
cd ..

# O si ya tienes archivos *_rag_documents.json (Opción B: offline)
# cd backend/ && ./setup_databases.sh --json-dir data/chunks --build-qa && cd ..
```

### 4. Construir y levantar

```bash
docker compose up -d --build
```

### 5. Verificar

```bash
# Ver logs (debe mostrar "Precalentamiento completado exitosamente")
docker compose logs -f taina-backend

# Ver estado
docker compose ps
```

***

## Probar el agente

### Con LiveKit Playground

1. Abre [LiveKit Playground](https://playground.livekit.io/)
2. Ingresa tu `LIVEKIT_URL`
3. Genera un token y conéctate a una sala
4. Habla en español: *"Hola, ¿qué servicios gubernamentales tienes?"*

### Con herramientas del catálogo

```bash
docker compose exec taina-backend python3 -c "
import asyncio
from src.tools import list_services

async def test():
    services = await list_services(limit=3)
    print('Servicios encontrados:', services)

asyncio.run(test())
"
```

### Health check

```bash
docker compose exec taina-backend python3 -c "
import asyncio
from src.tools import health_check

async def check():
    status = await health_check()
    for key, value in status.items():
        print(f'  {key}: {value}')

asyncio.run(check())
"
```

***

## Ejemplo de conversación

Una vez conectado al Playground, puedes probar estas consultas:

**Consulta básica:**

> *"Hola, soy María. Necesito renovar mi licencia de conducir."*

**Respuesta esperada de Taína:**

> *"¡Hola María! Soy Taína, tu asistente virtual del Gobierno de la República Dominicana.*
>
> *Para renovar tu licencia de conducir categoría 01, el costo es de mil novecientos pesos dominicanos.*
>
> *El procedimiento incluye:* *1. Presentarse en oficinas autorizadas* *2. Pasar por Registro* *3. Realizar Evaluación Médica*
>
> *¿Te gustaría saber las ubicaciones disponibles o prefieres información sobre el canal digital?"*

***

## Comandos esenciales

| Acción       | Comando                                |
| ------------ | -------------------------------------- |
| Iniciar      | `docker compose up -d`                 |
| Detener      | `docker compose down`                  |
| Ver logs     | `docker compose logs -f taina-backend` |
| Reiniciar    | `docker compose restart`               |
| Reconstruir  | `docker compose up -d --build`         |
| Ver recursos | `docker stats taina_backend`           |

***

## Solución de problemas rápidos

| Problema                        | Solución                                                                       |
| ------------------------------- | ------------------------------------------------------------------------------ |
| Contenedor no arranca           | `docker compose logs taina-backend` → revisar error                            |
| "API key not found"             | Verifica `backend/.env` y reconstruye                                          |
| "ChromaDB collection not found" | Verifica archivos en `backend/data/chunks/`                                    |
| El agente no responde           | Verifica `docker compose ps` → estado "Up"                                     |
| Puerto 8080 en uso              | Detén el servicio que usa el puerto o cambia el puerto en `docker-compose.yml` |

***

## Próximos pasos

* [Instalación detallada](/taina-agente-ia-ogtic/empezando-con-taina/installation.md) – Guía completa paso a paso
* [Variables de entorno](/taina-agente-ia-ogtic/empezando-con-taina/configuracion-entorno.md) – Referencia de cada credencial
* [Operación diaria](/taina-agente-ia-ogtic/operacion-y-monitoreo/despliegue.md) – Monitoreo y mantenimiento
* [Herramientas del agente](/taina-agente-ia-ogtic/referencias-tecnicas/api/tools.md) – Catálogo de funciones disponibles


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://public-intelligence.gitbook.io/taina-agente-ia-ogtic/empezando-con-taina/quick-start.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.