Guías
Asistentes propios
Crea IAs a partir de Sabiuco con tus instrucciones.
Un asistente es una IA propia construida sobre Sabiuco: le das un nombre, unas instrucciones y un comportamiento, y la usas desde la API como si fuera un modelo más, con su identificador asst_….
Sirve para no repetir las mismas instrucciones en cada petición y para cambiar el comportamiento de tu aplicación sin tocar su código: editas el asistente en el panel y el cambio se aplica en la siguiente petición.
Crear un asistente
En Asistentes → Nuevo asistente:
| Campo | Descripción |
|---|---|
| Nombre | Para reconocerlo en el panel (máx. 80 caracteres). |
| Descripción | Opcional, para ti. Aparece en GET /models. |
| Instrucciones | Cómo debe comportarse (máx. 12.000 caracteres). Es lo más importante. |
| Creatividad | Temperatura por defecto, de 0 a 1,5. Si la petición trae temperature, manda la de la petición. |
| Razonamiento | Activado: mejor en tareas complejas. Desactivado: más rápido y barato. reasoning_effort en la petición tiene prioridad. |
| Búsqueda web | Le permite consultar internet cuando lo necesite. Añade unos 7.000 tokens de entrada a cada petición. Si la conversación lleva alguna imagen, esa petición se responde sin buscar. |
Puedes tener hasta 20 asistentes. Borrar uno hace que sus llamadas respondan 404.
Usarlo
r = cliente.chat.completions.create(
model="asst_3CEBDMkWWGyK",
messages=[{"role": "user", "content": "¿Cuánto tarda un envío a Canarias?"}],
)Puedes añadir mensajes system en la petición para dar contexto concreto (por ejemplo, el nombre del cliente o su pedido). Se suman a las instrucciones del asistente, que tienen prioridad.
Cómo escribir buenas instrucciones
- Di quién es y para quién trabaja. «Eres el asistente de atención al cliente de Librería Aurora, una tienda online de libros en Madrid.»
- Explica qué debe hacer y qué no. «Resuelves dudas de pedidos, envíos y devoluciones. No das opiniones sobre libros ni hablas de otros temas.»
- Fija el formato. «Responde en un máximo de 4 frases. Usa listas solo si hay más de tres pasos.»
- Dale los datos que necesita. Plazos, precios, políticas, horarios. El asistente no los conoce si no se los das.
- Dile qué hacer cuando no sepa algo. «Si no puedes resolverlo, pide el número de pedido y di que el equipo responderá en 24 horas.»
Ejemplo
Eres el asistente de atención al cliente de Librería Aurora (tienda online, Madrid).
Resuelves dudas sobre pedidos, envíos y devoluciones. No hablas de otros temas: si te preguntan otra cosa, redirige con amabilidad.
Datos:
- Envío a la península: 24-48 h laborables, gratis desde 25 €; si no, 3,95 €.
- Baleares: 3-5 días, 6,95 €. Canarias, Ceuta y Melilla: 5-8 días, 9,95 €.
- Devoluciones: 30 días desde la entrega; el libro debe estar en perfecto estado.
Estilo: cercano, trato de tú, máximo 4 frases. Sin emojis.
Si no puedes resolverlo, pide el número de pedido (empieza por LA-) y di que el equipo responderá en 24 horas.Las instrucciones se envían en cada petición y cuentan como tokens de entrada: sé claro, pero sin relleno.