Skip to main content

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:
  1. Identifica la factory o servicio que lo construye.
  2. Revisa el perfil de modelo que usa.
  3. Revisa el prompt key y su fallback.
  4. Cambia el bundle de tools en tool-registry antes de tocar prompts.
  5. Si agregas capacidad nueva, documentala aqui y en el catalogo de tools.