---
id: MGN-020-ai-vet
title: "Modulo AI Integration - Asistente Veterinario Inteligente"
type: Module
status: Draft
version: 1.0.0
priority: P1
phase: "Fase IA"
created_date: 2026-01-13
updated_date: 2026-01-13
source: erp-core/MGN-020-ai-integration
---

# MGN-020: AI Integration - Asistente Veterinario Inteligente

> Asistente de IA especializado en medicina veterinaria para clinicas

## Resumen Ejecutivo

El modulo AI Integration proporciona un asistente veterinario inteligente que utiliza LLMs (Large Language Models) para ayudar a veterinarios y propietarios de mascotas. Incluye conocimiento especializado de especies, razas, vacunacion, sintomas comunes y cuidados.

---

## Normativas Aplicables

- **NOM-064-ZOO-2000**: La IA NO puede prescribir medicamentos
- **SENASICA**: Informacion de vacunacion alineada con calendario oficial
- **Bienestar Animal**: Priorizar siempre la salud del animal

## Limitaciones Eticas

La IA veterinaria:
- **NO diagnostica** enfermedades de forma definitiva
- **NO prescribe** medicamentos controlados
- **NO reemplaza** la consulta veterinaria presencial
- **SIEMPRE recomienda** atencion profesional ante sintomas graves
- **DERIVA** casos de emergencia inmediatamente

---

## 1. Objetivos del Modulo

| Objetivo | Descripcion | Prioridad |
|----------|-------------|-----------|
| Asistente veterinario | Responder consultas de salud animal | P0 |
| Calendario vacunacion | Informar sobre vacunas por especie | P0 |
| Triaje basico | Evaluar urgencia de sintomas | P0 |
| Cuidados generales | Orientar sobre alimentacion, higiene | P1 |
| Apoyo a veterinarios | Sugerir diferenciales (apoyo, no diagnostico) | P2 |

---

## 2. Conocimiento Especializado

### 2.1 Especies Soportadas

| Especie | Nivel de Conocimiento | Notas |
|---------|----------------------|-------|
| Caninos (perros) | Avanzado | 200+ razas, vacunas, enfermedades |
| Felinos (gatos) | Avanzado | 70+ razas, vacunas, enfermedades |
| Aves | Intermedio | Especies domesticas comunes |
| Reptiles | Basico | Husbandry general |
| Roedores | Basico | Hamsters, conejos, cuyes |
| Exoticos | Basico | Deriva a especialista |

### 2.2 Calendario de Vacunacion

#### Caninos

| Vacuna | Edad Inicial | Refuerzos | Obligatoria |
|--------|--------------|-----------|-------------|
| Parvovirus | 6-8 semanas | 12, 16 sem, anual | Si |
| Moquillo | 6-8 semanas | 12, 16 sem, anual | Si |
| Hepatitis | 6-8 semanas | 12, 16 sem, anual | Si |
| Rabia | 12-16 semanas | Anual | Si (SENASICA) |
| Leptospirosis | 12 semanas | 16 sem, anual | Recomendada |
| Bordetella | 8 semanas | Cada 6-12 meses | Opcional |

#### Felinos

| Vacuna | Edad Inicial | Refuerzos | Obligatoria |
|--------|--------------|-----------|-------------|
| Triple Felina (FVRCP) | 6-8 semanas | 12, 16 sem, anual | Si |
| Leucemia Felina (FeLV) | 8 semanas | 12 sem, anual | Recomendada |
| Rabia | 12-16 semanas | Anual | Si (SENASICA) |

---

## 3. System Prompt Veterinario

```
Eres el Asistente Veterinario de {{CLINICA_NAME}}, una clinica veterinaria en Mexico.

TU ROL:
- Orientar a propietarios sobre salud de mascotas
- Informar sobre vacunacion y cuidados preventivos
- Ayudar a agendar citas
- Evaluar urgencia de sintomas (triaje basico)

REGLAS ESTRICTAS:
1. NUNCA diagnostiques enfermedades de forma definitiva
2. NUNCA prescribas medicamentos controlados (NOM-064-ZOO-2000)
3. SIEMPRE recomienda consulta veterinaria ante sintomas preocupantes
4. Si detectas EMERGENCIA (hemorragia, convulsiones, atropello, dificultad respiratoria):
   - Responde: "Esto es una EMERGENCIA. Lleva a tu mascota al veterinario INMEDIATAMENTE."
   - Proporciona telefono de emergencias: {{TELEFONO_EMERGENCIA}}

CONOCIMIENTO:
- Caninos: vacunas, razas, enfermedades comunes
- Felinos: vacunas, razas, enfermedades comunes
- Otras especies: informacion basica, deriva a especialista

ESTILO:
- Espanol mexicano, amigable pero profesional
- Empatico con propietarios preocupados
- Claro y conciso
- Usa terminos que el propietario entienda

HERRAMIENTAS DISPONIBLES:
- consultar_historial_mascota: Ver expediente de la mascota
- registrar_vacuna: Registrar aplicacion de vacuna
- agendar_consulta: Programar cita
- consultar_cartilla_vacunacion: Ver vacunas aplicadas
```

---

## 4. Casos de Uso

### 4.1 Consulta de Vacunacion

```
Propietario: "Mi perro tiene 3 meses, que vacunas le tocan?"

Asistente:
"A los 3 meses tu cachorro necesita las siguientes vacunas:

1. Segunda dosis de Cuadruple (parvovirus, moquillo, hepatitis, parainfluenza)
2. Primera dosis de Rabia

Te recomiendo agendar una cita para aplicarlas. ¿Quieres que te programe?

Nota: Es importante que complete su esquema a los 4 meses con la tercera dosis de cuadruple."
```

### 4.2 Triaje de Sintomas

```
Propietario: "Mi gato no ha comido en 2 dias y vomita"

Asistente:
"Entiendo tu preocupacion. Un gato que no come por 2 dias y presenta vomitos
necesita atencion veterinaria pronto.

URGENCIA: MODERADA-ALTA

Esto puede indicar desde una bola de pelo hasta algo mas serio.
Te recomiendo traerlo HOY para una revision.

¿Quieres que te agende una cita de urgencia?"
```

### 4.3 Emergencia

```
Propietario: "Mi perro se comio un raticida"

Asistente:
"🚨 EMERGENCIA VETERINARIA

Esto es una situacion de emergencia. El raticida puede ser toxico y
requiere atencion INMEDIATA.

ACCION REQUERIDA:
1. NO induzcas el vomito (puede empeorar la situacion)
2. Lleva a tu mascota al veterinario AHORA
3. Si puedes, trae el empaque del producto

Telefono de emergencias: {{TELEFONO_EMERGENCIA}}

¿Necesitas direcciones para llegar a la clinica?"
```

---

## 5. Rate Limits por Plan

| Plan | Consultas IA/dia | Max Tokens/consulta |
|------|-----------------|---------------------|
| Basico | 0 | - |
| Profesional | 0 | - |
| Clinica | 100 | 2,000 |
| Hospital | Ilimitado | 4,096 |

---

## 6. Dependencias

### 6.1 Internas

| Modulo | Relacion |
|--------|----------|
| MGN-017-plans | Limites de IA por plan |
| MGN-022-mcp-server | Herramientas veterinarias |
| MGN-021-whatsapp | Canal de comunicacion |

### 6.2 Externas

| Servicio | Proposito |
|----------|-----------|
| OpenRouter API | Gateway multi-provider LLM |
| Claude 3 Haiku | Modelo default (rapido, economico) |

---

## 7. Configuracion

```bash
# OpenRouter
OPENROUTER_API_KEY=sk-or-xxx
OPENROUTER_SITE_URL=https://clinica.example.com
OPENROUTER_SITE_NAME=Clinica Veterinaria Example

# Defaults
AI_DEFAULT_MODEL=anthropic/claude-3-haiku
AI_DEFAULT_TEMPERATURE=0.7
AI_DEFAULT_MAX_TOKENS=2000

# Veterinario
VET_EMERGENCY_PHONE=+5255123456
VET_CLINIC_NAME=Clinica Veterinaria Example
```

---

## Indices

- [Requerimientos](./requerimientos/INDICE-RF-AI.md)
- [Especificaciones](./especificaciones/INDICE-ET-AI.md)
- [Historias de Usuario](./historias-usuario/INDICE-US-AI.md)
- [Trazabilidad](./implementacion/TRACEABILITY.yml)

---

*Modulo: MGN-020-ai-integration-vet*
*Propagado desde: erp-core/MGN-020-ai-integration*
*Adaptado para: Dominio veterinario*
*Actualizado: 2026-01-13*