# Instrucciones para el agente: SalesOps AI Assistant: procesa notas comerciales tras una llamada

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/Pyrex611/postcall-agents-system (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/postcall-agents

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Preparación

Comprueba Python ≥3.11 y pip para ese intérprete si vas a resolver las dependencias actuales: el README anuncia ≥3.9, pero google-adk actual exige ≥3.11 ([metadatos del paquete](https://pypi.org/project/google-adk/)). Verifica que puedes acceder a Gemini, a una cuenta de servicio con Sheets API y a una hoja de ensayo compartida con esa cuenta. Después descarga el proyecto.

### Paso 1: prepara una copia del proyecto

La línea de clonación del README está mal formada. Usa la URL real y un entorno aislado:

```bash
git clone https://github.com/Pyrex611/postcall-agents-system.git
cd postcall-agents-system
python3 -m venv .venv
source .venv/bin/activate
```

En Windows activa `.venv\Scripts\Activate.ps1` en PowerShell.

### Paso 2: instala las dependencias

En la carpeta del proyecto:

```bash
pip install -r requirements.txt
```

En la raíz crea un `.env` privado con `GOOGLE_API_KEY` de Gemini y `CRM_SHEET_NAME=Sales_CRM_Ensayo`. En Google Cloud habilita Sheets API y Drive API, crea una cuenta de servicio y guarda su clave JSON como `service_account.json` en esa raíz. Excluye ambos ficheros de Git. Crea la hoja `Sales_CRM_Ensayo` y compártela como Editor con el `client_email` de esa cuenta.

Hay una contradicción en el código: `tools/google_sheets_crm.py` abre la hoja por nombre (`client.open`), pero solicita solo el permiso de Sheets. Antes de probar, añade `https://www.googleapis.com/auth/drive` a su lista `scopes`, junto al de spreadsheets, como documenta [gspread](https://docs.gspread.org/en/latest/oauth2.html#for-bots-using-service-account). Es una adaptación local necesaria para esa búsqueda por nombre; habilitar la API sin solicitar el permiso no basta.

### Paso 3: inicia la interfaz

```bash
streamlit run app.py
```

## Comprobación

Abre http://localhost:8501. Carga el texto ficticio «Ana de Empresa Ensayo solicita una demostración el viernes; no ha decidido presupuesto» y comprueba el análisis, el borrador y la fila creada en la hoja de ensayo. Contrasta los campos con la transcripción y verifica que no se envía el correo automáticamente.

## Si algo falla

Si no encuentra la hoja, revisa su nombre y el acceso de la cuenta de servicio. Si falta la configuración de Gemini, completa el procedimiento del README antes de reintentar.

Consulta el [README oficial](https://github.com/Pyrex611/postcall-agents-system#readme) para el procedimiento completo y los cambios de versión.