01

→ PRIMERO, EL MAPA

Qué vas a construir

Abdi Agent es una Skill para Codex que convierte información aprobada de un negocio en un agente conversacional aislado, personalizable y preparado para varios canales.

Sitio + chat
POST /api/agent/chat
Cloudflare Worker
OpenAI Responses
Supabase
IMPORTANTE

Instalar la Skill no crea el agente automáticamente. Después debes abrir una tarea nueva e invocar $abdi-agent.

02

→ ANTES DE EMPEZAR

Prepara las herramientas

Necesitas Git, Codex con una sesión iniciada, acceso a terminal y Node.js 20 o posterior. Para publicar también necesitarás las cuentas del canal elegido.

  • Git instalado
  • Codex activo
  • Node.js 20+
  • Acceso al repositorio
git --version
node --version
03

→ INSTALA LA SKILL

Clona, copia y verifica

Clona el repositorio y conserva la carpeta completa: además de SKILL.md, Abdi necesita sus guías, referencias, scripts y plantillas.

git clone https://github.com/geipovadev/agente-abdi.git
cd agente-abdi
mkdir -p "$HOME/.codex/skills"
cp -R skills/abdi-agent "$HOME/.codex/skills/abdi-agent"

Comprueba la instalación y luego abre una tarea nueva en Codex.

test -f "$HOME/.codex/skills/abdi-agent/SKILL.md" && echo "Abdi Agent instalado"
04

→ EL NEGOCIO PRIMERO

Completa el onboarding

En una tarea nueva, inicia la Skill. Abdi preguntará de una a tres cosas por turno para confirmar identidad, servicios, información frecuente, límites y atención humana.

PROMPT PARA CODEX

Usa $abdi-agent para crear un agente nuevo para mi negocio.

  1. IdentidadNombre, descripción, público y cobertura.
  2. ServiciosQué incluye, excluye, resultado y precio.
  3. OperaciónHorarios, ubicación, pagos y preguntas frecuentes.
  4. Traspaso humanoCuándo, con quién, por qué canal y en qué horario.
NO INVENTAR

Si un dato no está confirmado, déjalo como pending. La configuración definitiva se crea solo después de una aprobación explícita.

05

→ AISLAMIENTO POR CLIENTE

Crea y valida la configuración

El archivo client.config.json separa los hechos del negocio de la conducta del agente. Empieza por un business_key único y estable.

business_key

Aísla configuración, conocimiento y datos.

identity + scope

Define quién es el negocio y qué puede responder.

channels

Activa únicamente canales con credenciales.

services

Incluye solo servicios confirmados y activos.

node skills/abdi-agent/scripts/validate-client-config.mjs client.config.json

No continúes si el validador muestra errores.

06

→ DEL ARCHIVO AL CANAL

Despliega y conecta canales

Aplica templates/supabase.sql, instala el Worker y, para web, copia el JavaScript y CSS del widget. El backend debe asignar el business_key; nunca debe confiar en uno enviado por el visitante.

<link rel="stylesheet" href="/assets/agent-widget.css">
<script src="/assets/agent-widget.js" data-endpoint="/api/agent" defer></script>
WEB/chat + /lead
WHATSAPPWebhook + HMAC
INSTAGRAMCuenta profesional
07

→ SEGURIDAD POR DISEÑO

Protege secretos y conversaciones

Los secretos viven únicamente en el proveedor o backend. Nunca en Git, HTML, capturas, chats o client.config.json.

OPENAI_API_KEYOPENAI_MODELSUPABASE_URLSUPABASE_SERVICE_ROLE_KEY
  • Servir el widget por HTTPS
  • Mantener store: false en OpenAI
  • Filtrar por business_key y status=approved
  • Aplicar rate limiting y validación
  • No persistir la conversación completa
08

→ ANTES DE PUBLICAR

Ejecuta pruebas de aceptación

Prepara al menos 12 casos y repite los afectados después de cada corrección.

IdentidadServiciosInclusionesPrecio conocidoPrecio no publicadoHorariosUbicaciónFuera de alcanceDato inexistenteAtención humanaCada canalNotas de voz

Tu agente está listo cuando el cliente confirma que las respuestas son correctas y que el traspaso humano funciona.

Volver a la biblioteca ↗