Vista general
Estos son los agentes reales identificados en el codigo del producto:
Teams Bot
TeamsBotModule registra factories para tres agentes y resuelve el prompt desde AiPromptRegistryService antes de construir cada instancia.
Archivos fuente:
apps/api-nestjs/src/modules/teams-bot/teams-bot.module.ts
apps/api-nestjs/src/modules/teams-bot/application/agents/internal-support-agent.ts
apps/api-nestjs/src/modules/teams-bot/application/agents/sales-agent.ts
apps/api-nestjs/src/modules/teams-bot/application/agents/engineering-agent.ts
Internal support
Responsabilidad:
- diagnostico operativo de equipos
- lectura de tickets, visitas y facturacion
- acciones privilegiadas como reset o restart cuando aplica
Puntos clave:
- se construye con
createReactAgent
- usa el prompt key
TEAMS_SUPPORT_AGENT_PROMPT_KEY
- depende de Prisma, Flespi, Emnify, tickets, billing y visitas
Sales
Responsabilidad:
- leer contexto comercial y de hilos
- coordinar reuniones y envios
- preparar email draft, cotizaciones y oportunidades
- enriquecer contexto con SII, web y Apollo
Puntos clave:
- combina context tools, ops tools y research tools
- usa el perfil
teams_sales_agent
- se activa dentro de Teams y trabaja sobre la conversacion actual
Engineering
Responsabilidad:
- revisar corridas de autofix
- inspeccionar issues de Sentry
- abrir corridas nuevas
- aprobar PRs o cerrar issues cuando corresponde
Puntos clave:
- hoy es el bundle mas acotado
- su prompt fuerza aprobacion explicita antes de aprobar PRs
- depende del tooling de
sentry-autofix
Para acciones de ingenieria con efecto real, la documentacion debe reflejar siempre si el agente puede leer, disparar o aprobar. No dejes ambigua esa diferencia.
AI Support
ugps_support_agent vive fuera de Teams y se centra en soporte de cliente.
Responsabilidad:
- lookup de dispositivo
- consulta de base de conocimiento
- revision de cuenta y suscripciones
- creacion de ticket si hace falta escalar
Archivo fuente:
apps/api-nestjs/src/modules/ai-support/application/agents/support-agent.ts
Prospect enrichment
prospect_enrichment_agent corre en quoter/ai y esta optimizado para research comercial acotado en costo y tiempo.
Puntos clave:
- limita llamadas a tools
- registra creditos por herramienta
- usa timeout para cortar corridas largas
- guarda el resultado en
enrichmentRepository
Archivo fuente:
apps/api-nestjs/src/modules/quoter/ai/application/agents/prospect-enrichment.agent.ts
Como extender un agente
Checklist minimo:
- Identifica la factory o servicio que lo construye.
- Revisa el perfil de modelo que usa.
- Revisa el prompt key y su fallback.
- Cambia el bundle de tools en
tool-registry antes de tocar prompts.
- Si agregas capacidad nueva, documentala aqui y en el catalogo de tools.