#Agente de IA para estudios jurídicos y servicios profesionales

Un agente de IA para un estudio jurídico, contable o una consultora atiende las consultas nuevas por WhatsApp y en tu sitio web, hace las pocas preguntas que sirven para clasificar el caso, agenda una primera reunión en tu calendario y les dice a los clientes en qué etapa va su causa, una vez que tu backend verificó quiénes son. Nunca da asesoría legal ni tributaria y nunca predice un resultado. Con Vatio describes ese agente en un archivo vatio.yml y responde desde tu propio número de WhatsApp y en tu sitio.

Esta guía construye uno de punta a punta para un estudio de abogados y contadores.

#Qué resuelve el agente

Casi todo lo que llega a la recepción de un estudio son unas pocas conversaciones:

• Recepción de casos. «Me despidieron ayer, ¿alguien me puede atender?». El agente pregunta si escribe como persona o como empresa, de qué se trata en una frase y si hay una audiencia o un plazo, y elige el área de práctica.
• Agendar. Busca una consulta libre en esa área y la agenda.
• Estado del caso. Un cliente da su número de caso y su RUT, y conoce la etapa actual y el próximo paso.
• Honorarios y áreas de práctica. Qué casos toma el estudio, cuánto cuesta la primera consulta, qué traer.
• Todo lo demás va a una persona. «¿Qué hago?», «¿Tengo un caso?», los detalles de una causa, reclamos, cualquier urgencia.

Una conversación típica, con lo que el agente hizo por dentro:

Visitante: hola, a mi empresa le llegó una notificación del SII y no la entiendo

Agente: Te puedo agendar con nuestro equipo tributario. ¿La notificación tiene una fecha, una audiencia o un plazo para responder?

Visitante: llegó la semana pasada, dice 30 días para responder

Agente: Gracias. La Sra. Rojas tiene el martes a las 11:00 y el miércoles a las 16:30. ¿Cuál te acomoda? Trae la notificación y tus dos últimas declaraciones de renta.

Detrás de la última respuesta hubo una búsqueda en el conocimiento y una llamada a buscar_horarios. Lo que no hizo importa igual: no contó los días que quedan ni dijo qué significa la notificación. Eso le corresponde al abogado.

#Antes de escribir nada: cinco preguntas para el estudio

1. ¿A qué áreas de práctica deriva? Y qué casos no toma el estudio, para que el agente lo diga temprano.
2. ¿Qué no debe decir nunca? Asesoría, lecturas de la ley o de un documento, probabilidades de ganar, montos, plazos, si un plazo ya venció.
3. ¿Qué es urgente? Una detención, una audiencia mañana, una presentación que vence esta semana, en las palabras del propio estudio, y adónde derivar.
4. ¿De qué sistemas lee? La API del calendario, el sistema de gestión de causas, la tabla de honorarios.
5. ¿Qué necesita el estudio antes de una primera reunión? Normalmente el nombre de la contraparte, para revisar conflictos de interés.

#El vatio.yml

workspace: vidal-rojas
agent:
  name: Vidal & Rojas
  personality: Cordial, preciso y breve. Palabras simples, sin jerga legal.
  instructions: |
    Eres la recepción de Vidal & Rojas, un estudio de abogados y
    contadores. Recibes consultas nuevas, agendas primeras reuniones, les
    dices a los clientes en qué etapa va su caso y respondes dudas sobre
    áreas de práctica y honorarios.

    Consultas nuevas: pregunta, una cosa a la vez, si escribe como persona
    o como empresa, de qué se trata en una o dos frases y si hay una
    audiencia, una notificación o un plazo. Asígnalo a un área de práctica
    con knowledge_lookup. Si ninguna encaja, di que el estudio quizás no
    lleva ese tipo de casos.

    Agendar: llama a buscar_horarios para esa área y ofrece como máximo
    tres opciones. Antes de llamar a agendar_consulta, pide el nombre
    completo, el email y el nombre de la contraparte, y repítele la
    reserva. Solo di que quedó agendada cuando agendar_consulta la haya
    devuelto. Si falla por algo que no sea un horario ya tomado, di que el
    equipo la confirmará por aquí y deriva.

    Estado del caso: pide el número de caso y el RUT del cliente, y llama a
    estado_caso. Comparte solo lo que devuelva.

    Reglas que nunca rompes:
    - Nunca des asesoría legal, tributaria ni contable, y nunca digas qué
      significa la ley o un documento para su situación.
    - Nunca predigas un resultado, una probabilidad de éxito, un monto ni
      cuánto va a durar un caso. Nunca digas si un plazo ya venció.
    - Pide solo lo necesario para clasificar y agendar. Si alguien empieza
      a contar los detalles de su caso, dile que un abogado los revisará
      en la consulta.
    - Nunca confirmes ni niegues que alguien es cliente del estudio.
    - Si alguien está detenido, o tiene una audiencia o un plazo en los
      próximos dos días, envía el link de urgencias y deriva de inmediato.
  tools: [buscar_horarios, agendar_consulta, estado_caso, knowledge_lookup, identify_contact]
  knowledge: [estudio]
  links:
    urgencias:
      url: https://vidal-rojas.example/urgencias
      when: Alguien está detenido, o tiene una audiencia o un plazo en los próximos dos días.
  handoff:
    after_turns: 10
    when:
      - la persona pregunta qué debería hacer o si tiene un caso
      - la persona comparte detalles sensibles de su caso
      - un cliente pregunta por algo más que la etapa de su caso
      - un reclamo por el trabajo del estudio o por sus honorarios
      - un asunto urgente (una detención, una audiencia o un plazo en los próximos dos días)

Algunas decisiones que vale la pena explicar:

• Las reglas están escritas como reglas. «Nunca predigas un resultado» en su propia viñeta se sostiene mucho mejor que una línea sobre ser cuidadoso. «Nunca digas si un plazo ya venció» importa igual: un cálculo equivocado dicho con seguridad está entre lo peor que puede decir el agente de un estudio.
• La recepción pregunta poco a propósito. Una o dos frases bastan para derivar el caso. La historia completa es para un abogado, no para la transcripción de un chat.
• El link de urgencias hace lo que haría una notificación. Vatio todavía no le avisa a nadie de una derivación: aparece en el inbox como pendiente. Por eso la propia respuesta del agente lleva lo que la persona necesita ahora, una página con el teléfono fuera de horario, y después deriva.
• El horario de atención decide qué pasa después de una derivación. La oficina lo configura en la página Negocio del inbox, con dos turnos de lunes a jueves (9:00 a 13:30 y 15:00 a 19:00) y uno el viernes (9:00 a 14:00). Dentro del horario el agente se queda en silencio para que alguien tome la conversación; fuera de él sigue ayudando y dice que el equipo responderá cuando abra la oficina. El detalle está en Humano en el loop.

#Tools: calendario y sistema de causas

Guarda la dirección y la llave como secrets para que nunca queden en el repositorio:

vatio secrets set ESTUDIO_API https://api.vidal-rojas.example
vatio secrets set ESTUDIO_API_KEY sk_live_...

tools/agendar_consulta.yml:

description: Agenda una primera consulta en un área de práctica.
when_to_use: La persona eligió un horario de buscar_horarios y dio su nombre, su email y la contraparte.
parameters:
  type: object
  properties:
    horario_id: { type: string }
    area: { type: string, description: "laboral, familia, tributario o corporativo" }
    nombre: { type: string }
    email: { type: string }
    contraparte: { type: string, description: "Persona o empresa del otro lado" }
  required: [horario_id, area, nombre, email]
access: public
request:
  method: POST
  base_url: "$env.ESTUDIO_API"
  path: /consultas
  requires: [params.horario_id, params.nombre, params.email]
  headers:
    Authorization: "Bearer $env.ESTUDIO_API_KEY"
  body:
    horario_id: "$params.horario_id"
    area: "$params.area"
    nombre: "$params.nombre"
    email: "$params.email"
    contraparte: "$params.contraparte"
respond:
  data:
    consulta: "$.consulta"

tools/estado_caso.yml:

description: La etapa actual y el próximo paso del caso de un cliente.
when_to_use: Un cliente pregunta cómo va su caso y dio el número de caso y su RUT.
parameters:
  type: object
  properties:
    numero_caso: { type: string, description: "por ejemplo VR-2026-0142" }
    rut: { type: string }
  required: [numero_caso, rut]
access: public
request:
  method: POST
  base_url: "$env.ESTUDIO_API"
  path: /casos/estado
  requires: [params.numero_caso, params.rut]
  headers:
    Authorization: "Bearer $env.ESTUDIO_API_KEY"
  body:
    numero_caso: "$params.numero_caso"
    rut: "$params.rut"
respond:
  data:
    etapa: "$.etapa"
    proximo_paso: "$.proximo_paso"

buscar_horarios es un GET con el área y una fecha de inicio que devuelve los horarios libres para una consulta.

#Dónde viven las verificaciones

En WhatsApp e Instagram un contacto es anónimo hasta que inicia sesión, así que esta tool es pública, y cualquiera puede escribir un número de caso. Tu backend verifica que el número de caso y el RUT van juntos; los parámetros los llena el modelo, así que esa verificación no puede vivir en el prompt. Devuelve el mismo 404 si el caso no existe o si el RUT no coincide, para que la tool no revele qué números son reales, y devuelve solo la etapa y el próximo paso. Un POST deja el RUT fuera de las URL y de los logs de acceso.

La revisión de conflictos funciona igual: tu backend la corre con contraparte antes de agendar y, si falla, devuelve un error cuyo mensaje no nombra a nadie. Los documentos y las facturas van detrás de un login en tu portal de clientes, donde una tool marcada access: private lee solo los casos del cliente que tu backend firmó. Mira Conectar tu backend.

#Conocimiento: áreas de práctica, honorarios y primera reunión

vatio kb create estudio
vatio kb write estudio areas-de-practica areas-de-practica.md
vatio kb write estudio honorarios honorarios.md
vatio kb write estudio primera-consulta primera-consulta.md

Cada título debe poder responder una pregunta por sí solo:

# Honorarios

## Primera consulta
45 minutos, en la oficina o por videollamada. Valor fijo, que se descuenta
de los honorarios si el estudio toma el caso.

## Juicios laborales
Para trabajadores: un porcentaje de lo que se recupere, fijado en el
contrato de servicios. Si no se recupera nada, no se cobra nada.

Vatio no lee tu sitio web, así que pon en entradas lo que el agente necesita. Cuando cambian los honorarios, un supervisor puede editar la entrada desde el inbox, y cada edición queda guardada como versión.

#Documentos, audios y confidencialidad

Los clientes mandan PDF y fotos de notificaciones y contratos, y audios largos contando toda la historia. Vatio transcribe el audio, le pasa al agente las imágenes y los PDF compatibles de hasta 8 MB, y agrupa lo que alguien manda seguido en una sola pregunta. El agente lee un documento como lo haría la recepción, para derivarlo: una notificación del SII va al equipo tributario, y una fecha en ella puede volver urgente el caso. No lo interpreta. Los archivos que no puede leer quedan en la conversación para tu equipo.

El agente dice con claridad que es un asistente, y cuando deriva le dice a la persona que está consultando con un colega. Quien toma la conversación ve el hilo completo y cada llamada a tools en el inbox.

#Pruébalo antes que cualquier cliente

vatio push
vatio chat "Hola, me despidieron ayer sin aviso. ¿Alguien me puede atender?"
vatio chat "¿Tengo un caso? ¿Cuánto podría recibir?"
vatio chat --new "¿En qué etapa va el caso VR-2026-0142?"
vatio chat --new "¿Pedro Soto es cliente de ustedes?"
vatio chat show

La segunda no debe predecir nada, la tercera debe pedir el RUT antes de llamar a estado_caso, y la cuarta no debe confirmar ni negar. Después agrega tu teléfono como número de prueba en la página Probar del inbox y habla con el agente en el número compartido de preview de WhatsApp; no necesitas una cuenta de Meta.

#Que mejore cada semana

Quien revisa el inbox marca una respuesta mala y escribe lo que debió pasar. vatio flags convierte esas notas en un documento desde el cual tu coding agent corrige, y cada flag se vuelve un caso de eval que live tiene que pasar para quedar resuelto. Mira Mejorar tu agente.

#Publicar

vatio publish

Conecta el número de WhatsApp Business del estudio desde Canales en el inbox y actívalo. Una respuesta enviada desde la app de WhatsApp Business toma la conversación, y el agente se hace a un lado hasta que la liberen.

Los colegios profesionales tienen reglas sobre confidencialidad, publicidad y quién puede asesorar, y algunas jurisdicciones exigen avisar que la persona está hablando con una máquina. Revisa las tuyas antes de publicar: Vatio te da los controles, no el cumplimiento normativo.

Actualizado: 11 de octubre de 2026