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). 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:

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:

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

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 para el procedimiento completo y los cambios de versión.