Crea tu primer agente
De la idea a una versión guardada, paso a paso y conversando.
Esta guía arma un agente de soporte para una tienda en línea. Puedes pedírselo al chatbot en un solo mensaje, pero ir paso a paso te deja revisar cada parte.
Cómo trabaja un agente#
Antes de empezar, tres ideas:
- El borrador es la configuración que estás editando. Tus clientes no lo ven.
- Guardar una versión congela el borrador. Las versiones no cambian nunca.
- Publicar elige qué versión atiende a tus clientes, en todos los canales.
1. Escribe las instrucciones#
"Crea unas instrucciones llamadas 'Soporte tienda'. El agente atiende clientes de una tienda de ropa en Colombia, responde en español con tono cercano, pide el número de pedido antes de dar información de envíos y nunca promete reembolsos: los deriva a soporte@mitienda.com."
El chatbot usa create_instruction_set y crea la versión 1. Si después quieres cambiar algo, pídelo y se guardará como versión 2 sin perder la anterior.
Consejo
Unas buenas instrucciones dicen quién es el agente, a quién atiende, qué tono usa y qué no debe hacer nunca. Pide al chatbot que te proponga una estructura antes de escribirlas.
2. Crea el agente#
"Crea un agente llamado 'Soporte tienda' y úsale esas instrucciones."
El chatbot crea el agente (create_agent) y apunta su borrador a las instrucciones (update_agent_draft). Si tu plan ya llegó a su límite de agentes, te lo dirá.
3. Ajusta la configuración#
Algunos ejemplos de lo que puedes pedir:
- "Usa un modelo más económico." El chatbot consulta
list_modelsy te propone opciones. - "Que recuerde lo que cada cliente le contó en la conversación."
- "Limita cada respuesta a 20 pasos y 2 minutos."
- "Que sepa la hora de Bogotá."
Cada cambio toca solo lo que pediste: el resto del borrador queda igual.
4. Valida y guarda una versión#
"Valida el borrador y, si no hay errores, guarda una versión."
validate_agent_draft revisa que todo lo que usa el agente exista y que tu plan lo permita. Los errores impiden guardar y las advertencias no. Luego save_agent_version crea la versión 1.
Nota
Si pides guardar sin haber cambiado nada, el chatbot te avisará: no se crean versiones idénticas.
5. Revisa antes de publicar#
"Muéstrame el prompt final de la versión 1 y cuánto contexto ocupa."
Con get_system_prompt y get_context_usage ves exactamente lo que recibe el modelo y cuánto espacio queda para la conversación.
Siguiente paso#
Antes de publicar, pruébalo con casos de calidad.