> Construye un agente de IA que responde sobre carreras, aranceles y requisitos, revisa el estado de una postulación y agenda visitas, sin prometer cupos. # Agente de IA para colegios, universidades y admisión Un agente de IA para un colegio o una universidad atiende a los futuros estudiantes, y a los padres que escriben por ellos, por WhatsApp, Instagram y tu sitio de admisión: carreras, aranceles, requisitos de admisión y becas, el estado de una postulación, y una visita al campus o una llamada con un asesor. Nunca promete un cupo ni una beca. Con Vatio describes ese agente en un archivo `vatio.yml` y responde desde tu propio número de WhatsApp, tu cuenta de Instagram y tu sitio web. ## Qué resuelve el agente Los equipos de admisión responden las mismas preguntas en cada proceso: - **Carreras.** Qué cubre una carrera, cuánto dura, en qué sede. - **Aranceles y becas.** El arancel de una admisión determinada, y qué pide cada beca. - **Requisitos y plazos.** Documentos, puntajes, entrevistas, fechas de cierre. - **Estado de la postulación.** La etapa y los documentos que faltan. - **Visitas y llamadas.** Una visita guiada al campus o una llamada con un asesor. - **Todo lo demás va a una persona.** Excepciones, apelaciones, apoyo por discapacidad, facilidades de pago. Una conversación típica: > **Madre:** hola, escribo por mi hija. quiere estudiar enfermería, qué necesita? > > **Agente:** Con gusto te ayudo. Para Enfermería necesita su licencia de enseñanza media, su puntaje PAES y una entrevista. Las postulaciones para la admisión 2027 cierran el 15 de enero. ¿Les serviría una visita al campus? > > **Madre:** sí, si hay alguna un sábado > > **Agente:** Hay visitas guiadas este sábado a las 10:00 y el sábado 18 a las 11:30. ¿Cuál les acomoda, y cómo se llama tu hija? Detrás de esas respuestas hubo una búsqueda en el conocimiento, una llamada a `buscar_horarios_visita` y una nota con `remember` sobre Enfermería para la admisión 2027, todo visible en el inbox. ## Antes de escribir nada: cinco preguntas para la institución 1. **¿Quién escribe y para qué?** Futuros estudiantes y sus padres, sobre carreras, aranceles y plazos; postulantes, sobre su estado. 2. **¿Qué no debe decir nunca?** Promesas de admisión o de becas, probabilidades según puntaje, aranceles de una admisión que todavía no tiene precio. 3. **¿Cuándo toma la conversación una persona?** Excepciones, apelaciones, apoyo por discapacidad, facilidades de pago. 4. **¿De qué sistemas lee?** La API del sistema de admisión, el calendario donde se agendan las visitas, la tabla de aranceles, las reglas de las becas. 5. **¿Qué puede revelar un número de postulación?** Decide qué puede saber alguien que lo tiene junto con el RUT del postulante. Normalmente la etapa y los documentos que faltan; nunca el resultado. Las respuestas se convierten en las instrucciones, las condiciones de `handoff`, las tools y el conocimiento, en ese orden. ## El `vatio.yml` ```yaml workspace: instituto-austral agent: name: Admisión Instituto Austral personality: Claro, paciente y cercano. Nunca insistente. instructions: | Atiendes a los futuros estudiantes del Instituto Austral, y a los padres o apoderados que escriben por ellos, sobre carreras, aranceles, requisitos, becas y plazos. Carreras, aranceles, requisitos, becas y fechas: responde solo con lo que devuelva knowledge_lookup, y di siempre a qué admisión corresponde un arancel. Si no encuentras la respuesta, dilo y ofrece pasarle la pregunta a un asesor. Visitas y llamadas con un asesor: pregunta qué carrera le interesa, llama a buscar_horarios_visita y ofrece como máximo tres opciones. Pide un nombre, un correo y, salvo en WhatsApp, un teléfono, y llama a agendar_visita. Solo di que quedó agendada cuando agendar_visita la haya devuelto. Estado de la postulación: pide el número de postulación y el RUT del postulante, y llama a estado_postulacion. Informa la etapa y los documentos que faltan. Si el resultado está listo, di que se envió por correo y que está en el portal de postulantes; nunca comuniques el resultado tú mismo. Padres y apoderados: ayúdalos igual. Guarda el nombre de quien escribe con identify_contact. Usa remember para guardar la carrera y la admisión que evalúa la familia, y recall cuando vuelvan. Reglas que nunca rompes: - Nunca prometas ni predigas la admisión, un cupo o una beca, y nunca estimes las probabilidades de alguien a partir de sus notas o su puntaje. Deciden las comisiones de admisión y de becas. - Nunca des un arancel, una fecha o un requisito que el conocimiento no haya devuelto. - Nunca compartas nada de una postulación sin su número y el RUT del postulante. tools: [knowledge_lookup, buscar_horarios_visita, agendar_visita, estado_postulacion, identify_contact, remember, recall] knowledge: [admision] links: postular: https://instituto-austral.example/postular portal: https://instituto-austral.example/postulantes carrera: url: https://instituto-austral.example/carreras/{carrera} when: La persona quiere la página completa de una carrera. values: carrera: [enfermeria, ingenieria-comercial, ingenieria-de-software, diseno-grafico] handoff: after_turns: 14 when: - la persona pide una excepción a un requisito o a un plazo - la persona no está de acuerdo con un resultado de admisión o de beca - consultas sobre apoyo por discapacidad o una condición de salud - la persona pregunta por facilidades de pago o dificultades económicas ``` Algunas decisiones que vale la pena explicar: - **El agente nunca comunica un resultado.** Un resultado merece las palabras que eligió tu equipo de admisión, no un chat en el teléfono compartido de la familia. El endpoint de abajo ni siquiera lo devuelve, así que la regla no depende solo del prompt. - **Aranceles solo desde el conocimiento, siempre con su admisión.** Un arancel informado para el año equivocado es una promesa que alguien te va a cobrar. - **`after_turns: 14`** es más alto que en un agente de reservas porque las conversaciones de admisión son largas. Pasados catorce mensajes, la conversación va a una persona. ## Tools: estado de la postulación y visitas Una tool es un request HTTP a tu backend, descrito en YAML. Guarda la dirección y la llave como secrets: ```bash vatio secrets set AUSTRAL_API https://api.instituto-austral.example vatio secrets set AUSTRAL_API_KEY sk_live_... ``` `tools/estado_postulacion.yml`: ```yaml description: Obtiene la etapa de una postulación y los documentos que faltan. when_to_use: Alguien pregunta por una postulación y dio su número y el RUT del postulante. parameters: type: object properties: numero_postulacion: { type: string, description: "por ejemplo PO-2027-04812" } rut: { type: string, description: "El RUT del postulante, no el del apoderado" } required: [numero_postulacion, rut] access: public request: method: POST base_url: "$env.AUSTRAL_API" path: /postulaciones/estado requires: [params.numero_postulacion, params.rut] headers: Authorization: "Bearer $env.AUSTRAL_API_KEY" body: numero_postulacion: "$params.numero_postulacion" rut: "$params.rut" respond: data: etapa: "$.etapa" documentos_faltantes: "$.documentos_faltantes" ``` `tools/agendar_visita.yml`: ```yaml description: Agenda una visita al campus o una llamada con un asesor en un horario libre. when_to_use: La persona eligió un horario de buscar_horarios_visita y dio un nombre y una forma de contactarla. parameters: type: object properties: horario_id: { type: string } nombre_estudiante: { type: string } correo: { type: string } telefono: { type: string, description: "Solo Instagram y web. En WhatsApp la tool usa el número del contacto" } carrera: { type: string, description: "por ejemplo enfermería, ingeniería comercial" } required: [horario_id, nombre_estudiante, carrera] access: public request: method: POST base_url: "$env.AUSTRAL_API" path: /visitas requires: [params.horario_id, params.nombre_estudiante] headers: Authorization: "Bearer $env.AUSTRAL_API_KEY" body: horario_id: "$params.horario_id" nombre_estudiante: "$params.nombre_estudiante" correo: "$params.correo || $contact.email" telefono: "$params.telefono || $contact.phone_number" carrera: "$params.carrera" respond: data: visita: "$.visita" ``` `buscar_horarios_visita` es un `GET` con el tipo de visita, la carrera y una fecha. `||` toma lo que la persona escribió o, si no, lo que ya está en su contacto. En WhatsApp el número ya está en el contacto, así que el agente lo pide solo en Instagram y en el sitio web. En una llamada con un asesor, es el asesor quien llama a la hora agendada; el agente solo la agenda. La seguridad de este agente vive en la tool de estado. En WhatsApp e Instagram un contacto es anónimo mientras no [inicie sesión](https://vatio.ai/docs/authentication/sessions#on-whatsapp), así que `estado_postulacion` es pública, y el número más el RUT es lo único que separa a un desconocido de una postulación. **Tu backend verifica que ambos coincidan**, responde a un RUT que no coincide exactamente igual que a un número que no existe, y limita los intentos. Es un `POST` para que el RUT nunca quede en una URL. Y lo que devuelva es lo que va a saber cualquiera que tenga esos dos datos, así que devuelve solo la etapa y los documentos que faltan. La postulación completa va detrás del login de tu portal de postulantes, donde el mismo agente puede usar una [tool privada](https://vatio.ai/docs/authentication/tools) que lee `$auth.subject` en vez de pedir números. ## Conocimiento: carreras, aranceles y becas ```bash vatio kb create admision vatio kb write admision carreras carreras.md vatio kb write admision aranceles-2027 aranceles-2027.md vatio kb write admision requisitos requisitos.md vatio kb write admision becas becas.md ``` Una entrada que dice con claridad quién decide hace fácil cumplir la regla de no prometer: ```markdown # Becas ## Beca de excelencia académica Para estudiantes de primer año con un puntaje PAES destacado. No hay formulario aparte: cuenta la postulación de admisión. La comisión de becas decide quién la recibe, y por qué monto, después de publicados los resultados de admisión. Nadie puede confirmarla antes. ## Plazo Las postulaciones a becas para la admisión 2027 cierran el 15 de diciembre de 2026. ``` Vatio no lee tu sitio web, así que los aranceles y los requisitos van en entradas. Cuando la siguiente admisión tenga precio, escribe `aranceles-2028` junto a `aranceles-2027`, no encima. ## Padres, estudiantes y conversaciones que duran meses Muchas conversaciones las empieza un padre o una madre, y la postulación es del estudiante. Las instrucciones resuelven ambas cosas: - **Quien escribe es el contacto.** `identify_contact` guarda el nombre de quien escribe, así que el inbox muestra al apoderado y no a un estudiante que nunca escribió. - **Los datos del estudiante abren la postulación.** Un apoderado con el número de postulación y el RUT del estudiante obtiene la etapa como cualquier otra persona. La regla es la misma para todos, y eso es lo que la hace segura. - **La memoria se mantiene.** La gente investiga una carrera meses antes de postular. Una conversación de WhatsApp continúa hasta que el último mensaje tiene más de ocho horas; la siguiente empieza de cero. Con `remember` y `recall`, lo que se guardó en marzo sigue ahí en octubre, y los supervisores leen las mismas notas en el contacto, en el inbox. ## Pruébalo antes que cualquier postulante ```bash vatio push vatio chat "Hola, ¿qué necesito para postular a Enfermería?" vatio chat "Saqué 720 puntos en la PAES. ¿Voy a quedar? ¿Y la beca?" vatio chat --new "Soy su mamá. Postulación PO-2027-04812, ¿en qué va?" vatio chat --new "¿Cuánto cuesta Ingeniería Comercial para la admisión 2028?" vatio chat show ``` La segunda no debe prometer ni estimar nada. La tercera no trae RUT, así que el agente tiene que pedir el del estudiante y no decir nada hasta tenerlo. La cuarta pide un arancel que todavía no está en el conocimiento. Después agrega tu teléfono como número de prueba en el preview compartido de WhatsApp y pruébalo como un apoderado que manda un audio. ## Que mejore cada semana Cuando el equipo de admisión revisa el inbox, **marca** cualquier respuesta que estuvo mal y escribe lo que debió pasar: «el plazo de Diseño Gráfico se movió al 30 de enero». `vatio flags` convierte esas notas en un documento desde el cual tu coding agent puede corregir, cada flag se vuelve un caso de eval, y el flag queda marcado como resuelto cuando live lo pasa. Mira [Mejorar tu agente](/es/guias/mejorar-tu-agente-de-ia). ## Publicar ```bash vatio publish vatio tokens create --env live --label admision --origin https://instituto-austral.example ``` El token va en el script del widget en tu sitio de admisión. Después conecta tu número de WhatsApp Business y tu cuenta de Instagram en la página **Canales** del inbox, y activa el interruptor **En vivo** de WhatsApp. Instagram responde apenas la cuenta queda conectada. El agente nunca decide por su cuenta escribir primero; los recordatorios de plazos salen por WhatsApp cuando tu sistema de admisión los envía con la [Messages API](https://vatio.ai/docs/api/messages). Las postulaciones tienen datos personales, muchas veces de menores de edad. Vatio nunca pone el contenido de una conversación en el correo diario de reportes, y lo que la normativa local exige sobre el manejo de los datos de los postulantes sigue siendo tuyo de revisar. ## Preguntas frecuentes ### ¿Un agente de IA puede responder consultas de admisión de un colegio o universidad? Sí. Las carreras, aranceles, requisitos, becas y plazos van en entradas de conocimiento que tú escribes, y el agente responde desde ellas por WhatsApp, Instagram y tu sitio web. Vatio no lee tu sitio web, así que todo lo que el agente deba saber tiene que estar en una entrada. ### ¿Los postulantes pueden revisar el estado de su postulación por WhatsApp? Sí, con el número de postulación y el RUT del postulante. Una tool pública envía ambos a tu backend, que responde solo si coinciden y devuelve la etapa y los documentos que faltan. La postulación completa va detrás del login de tu portal de postulantes. ### ¿El agente va a prometer un cupo o una beca? No, si escribes la regla. Dile que nunca prometa ni prediga la admisión o una beca y que nunca estime las probabilidades a partir de notas o puntajes, y prueba justamente eso con vatio chat antes de publicar. Los supervisores marcan cualquier respuesta que se escape, y cada flag se vuelve un caso de eval. ### ¿Los padres pueden hablar con el agente en nombre de sus hijos? Sí. El agente los ayuda igual, guarda el nombre del padre o la madre como contacto y pide el número de postulación y el RUT del estudiante para leer una postulación. Puede recordar qué carrera y qué admisión está evaluando la familia para la siguiente conversación. ### ¿El agente puede agendar visitas al campus y llamadas con un asesor? Sí, con tools que llaman a la API del calendario o del sistema de admisión donde las agendas. El agente reserva el horario; en una llamada con un asesor, es el asesor quien llama al estudiante a esa hora. El agente no hace llamadas.