Referencia
Herramientas
Las nueve, con sus parámetros y lo que devuelven.
Cinco preguntas y cuatro acciones. tools/list solo devuelve las que caben en
los permisos concedidos: una herramienta que el corredor no autorizó no existe
para su asistente.
buscar
leads:read — el punto de entrada. Devuelve coincidencias de clientes y de
propiedades, no el expediente completo.
textostringrequiredNombre, teléfono, correo, dirección o barrio. Mínimo 2 caracteres.
limitenumberMáximo de resultados por tipo. Por defecto 8, máximo 25.
Esta herramienta devuelve dos familias de datos, así que su permiso declarado
no basta: comprueba además properties:read por su cuenta. Si no, un permiso
que el corredor desmarcó no querría decir nada.
ver_expediente
leads:read — el expediente entero de un cliente: operaciones, etapa, bien,
visitas, ofertas, documentos, últimos mensajes, y el próximo gesto que
recomienda el Copiloto.
lead_iduuidId del cliente. Uno de los dos es obligatorio.
operacion_iduuidId de la operación; se resuelve su cliente.
Sección por sección comprueba los permisos, y devuelve en permisos_faltantes
lo que tuvo que quitar. Sin eso, una sección vacía por falta de permiso sería
indistinguible de una sección realmente vacía, y el asistente respondería « no
tiene visitas » sobre un expediente que tiene tres.
mi_jornada
operations:read — los próximos gestos, el turno propio primero, lo más
atrasado delante.
alcancestringmios por defecto. Un responsable puede pedir toda la agencia; un agente
restringido no. El parámetro nunca amplía más allá del rol.
limitenumberPor defecto 15, máximo 50.
buscar_propiedades
properties:read — la cartera.
textostringPalabras del título, la dirección o el barrio.
listing_typestringsale = venta, rent = alquiler.
property_typestringTipo de inmueble.
property_statusstringEstado de la ficha. Por defecto no filtra.
ciudadstringbarriostringagenda
viewings:read — las visitas de una ventana de tiempo.
desdeISO 8601Por defecto, ahora.
hastaISO 8601Por defecto, 7 días después de desde.
estadostringEstado de la visita.
alcancestringmios por defecto.
crear_lead
leads:write — un contacto que el agente acaba de tener. « Acabo de hablar con
Marta Ríos, busca un 3 recámaras en San Francisco hasta 250 mil. »
full_namestringrequiredphonestringCon o sin formato.
emailstringoperation_typebuy | rentSi lo omites, se crea el cliente sin operación abierta.
budget_maxnumberbedrooms_minnumbernotesstringLo que contó el cliente, en sus palabras.
Los leads de captación —vendedores y propietarios— no se crean por aquí. Una captación se negocia y termina en un mandato firmado; no nace de una frase.
agendar_visita
viewings:write — confirmada en el huso horario de la agencia, que viene de
su Market Pack. Una visita a las 4 de la tarde no puede aparecer a las 9 de la
noche porque el asistente vive en otro huso.
lead_iduuidrequiredUsa buscar si no lo tienes.
scheduled_atISO 8601requiredproperty_iduuidLa propiedad que se va a ver.
operation_iduuidtypestringduration_minutesnumberEntre 15 y 480.
notesstringavanzar_etapa
operations:write — un paso de pipeline, por la misma validación que el botón
« Avanzar » de la aplicación. Está marcada como destructiva: los clientes que
piden confirmación al usuario la piden aquí.
operation_iduuidrequiredstagestringrequiredlost_reasonstringObligatorio para cerrar como perdida.
amountnumberMonto negociado, si cambió.
Cuando la compuerta rechaza, no se escribe nada y el asistente recibe qué falta, en español y con sus identificadores:
Todavía no se puede avanzar: la etapa actual tiene 4 paso(s) pendiente(s) —
Oferta preparada con el comprador · Oferta enviada al vendedor ·
Respuesta del vendedor recibida · Precio acordado.
Dile al agente qué falta; se marcan en Orkasa, en la operación.
Los identificadores viajan en structuredContent, para que el modelo pueda
seguirlos uno por uno en el turno siguiente.
registrar_oferta
offers:write — una oferta recibida. No la acepta y no mueve la etapa.
operation_iduuidrequiredamountnumberrequiredcurrencystringTres letras. Por defecto, la de la operación.
property_iduuidconditionsstringterm_monthsnumbernotesstringPor qué no hay una herramienta marcar_paso
La continuación natural sería « marca estos cuatro pasos como hechos ». No existe, a propósito: marcar un paso no es marcar una casilla.
precioAcordado pasa la oferta a accepted, lo que devuelve el bien a
pending y pausa sus publicaciones. ofertaPreparada crea una fila de oferta y
exige un monto. cartaPreaprob crea un documento y hace avanzar el
financiamiento.
Una herramienta genérica de « marcar hecho » dejaría que una frase de chat
acepte una oferta y despublique un anuncio. Si algún día se cierra ese círculo,
será con verbos precisos cuyo sentido quepa en una frase — como
registrar_oferta — nunca con una casilla.