> 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/arquitectura-y-conceptos/architecture/c4-model/2.1_context_view.md).

# Contexto

Esta vista describe, en lenguaje natural, cómo Taína IA se relaciona con sus actores clave, con los sistemas externos y con los distintos canales de despliegue. El Diagrama de Contexto proporciona una vista de alto nivel del sistema y sus interacciones con usuarios y sistemas externos.

<figure><img src="/files/FHVelRui2CyTsgVpxxPQ" alt=""><figcaption></figcaption></figure>

## Actores principales

* **Ciudadano**: persona que busca servicios gubernamentales, interactúa con Taína para acceder de manera ágil a la información y a los servicios ofrecidos por las instituciones públicas, comunicándose en idioma español durante todo el proceso.
* **Agente gubernamental**: miembro del personal que asiste a los ciudadanos, utiliza el sistema para guiarlos en la navegación y acceso a los distintos servicios gubernamentales, manteniendo la comunicación en idioma español.
* **Administrador del sistema**: personal técnico responsable de la gestión del sistema, se encarga de configurar y monitorear la plataforma Taína, garantizando su correcto funcionamiento. Además, administra la base de conocimientos y mantiene actualizada la configuración del sistema para asegurar la precisión y eficiencia en las respuestas del asistente.

## Componentes del sistema Taína

* **Voice AI UI (Frontend)**: interfaz de usuario basada en web, ofrece una experiencia conversacional en español, permitiendo al ciudadano interactuar de forma natural con el sistema. Captura la entrada de audio, reproduce la salida generada por el asistente y presenta en pantalla las transcripciones de las conversaciones, junto con la información detallada sobre los servicios gubernamentales consultados.
* **Agente de voz (Backend LiveKit)**: el sistema procesa el audio y gestiona las conversaciones de manera inteligente, integrándose con APIs externas para el procesamiento de voz y lenguaje natural. Además, recupera información de la base de conocimientos y administra la lógica de negocio, ejecutando las funciones necesarias para ofrecer respuestas precisas y contextualizadas a las solicitudes de los usuarios.
* **Base de conocimiento dual (ChromaDB)**: almacena información estructurada de servicios y pares pregunta-respuesta para respaldar la conversación.

## Sistemas externos

* **Google Gemini (LLM + Embeddings)**: componente de comprensión y generación de lenguaje natural, procesa las interacciones del usuario, interpretando el contexto de la conversación y reconociendo la intención detrás de cada consulta. A partir de esta comprensión, genera respuestas adecuadas y relevantes, orientadas a satisfacer las necesidades y preguntas de los ciudadanos de manera clara y eficiente.
* **Deepgram (STT)**: componente de reconocimiento de voz, convierte la voz en español a texto de manera precisa, con capacidad para manejar jerga y acentos del idioma. Además, ofrece transcripción en tiempo real, permitiendo que las conversaciones sean interpretadas y procesadas de forma inmediata por el sistema.
* **ElevenLabs (TTS)**: módulo de conversión de texto a voz, transforma las respuestas generadas por el sistema en una voz natural en español, con soporte para el acento dominicano. De esta manera, proporciona una salida de voz fluida y cercana al contexto local, mejorando la experiencia conversacional del usuario.

## Canales de despliegue

* **Quioscos físicos**: instalaciones físicas en oficinas gubernamentales y espacios públicos, brindan a los ciudadanos un punto de acceso directo a Taína, mediante una interfaz táctil y de voz. Estos quioscos permiten interactuar con el asistente de manera intuitiva y accesible, facilitando la obtención de información y la gestión de servicios en lugares de atención al público.
* **Plataforma web**: proporciona acceso a Taína basado en navegador ofreciendo una experiencia fluida con los servicios gubernamentales existentes en la base de conocimientos.


---

# 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/arquitectura-y-conceptos/architecture/c4-model/2.1_context_view.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.