rckrdmrd
c4620ca4e9
- Update docs/_MAP.md with new phase references - Add docs/04-fase-saas/ phase structure - Add docs/05-fase-ia/ phase structure Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
249 lines
6.9 KiB
Markdown
249 lines
6.9 KiB
Markdown
---
|
|
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*
|