> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ugps.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Agentes

> Resumen operativo de los agentes reales que hoy existen en Raul

## Vista general

Estos son los agentes reales identificados en el codigo del producto:

| Agente | Modulo | Canal principal | Perfil de modelo | Tools |
| - | - | - | - | - |
| `ugps_internal_support_agent` | `teams-bot` | Teams interno | `support_agent` | `support_core`, `support_context`, `support_privileged` |
| `ugps_sales_agent` | `teams-bot` | Teams interno | `teams_sales_agent` | `sales_context`, `sales_ops`, `commercial_research` |
| `ugps_engineering_agent` | `teams-bot` | Teams interno | `teams_engineering_agent` | `engineering_ops` |
| `ugps_support_agent` | `ai-support` | soporte asistido | `support_agent` | `support_core` |
| `prospect_enrichment_agent` | `quoter/ai` | enrichment comercial | `prospect_enrichment` | `commercial_research` |

## 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`

<Warning>
  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.
</Warning>

## 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.