clinica-veterinaria/docs/05-fase-ia/MGN-020-ai-integration/README.md
rckrdmrd c4620ca4e9 [DOCS] feat: Add phase 04-SAAS and 05-IA documentation structure
- 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>
2026-01-16 00:28:18 -06:00

6.9 KiB

id title type status version priority phase created_date updated_date source
MGN-020-ai-vet Modulo AI Integration - Asistente Veterinario Inteligente Module Draft 1.0.0 P1 Fase IA 2026-01-13 2026-01-13 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

# 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


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