API DE RESERVAS PARA AGENTES DE IA · REST + MCP

Dale a tu agente de IA capacidad para reservar.

Utiliza una única interfaz normalizada para discovery, disponibilidad en tiempo real, estado de reservas y acciones compatibles sobre plataformas de reservas conectadas a Talenthia.

Pre-piloto operativo · REST + MCP · 12 operaciones de aplicación · Certificación live con plataformas pendiente

ORIENTACIÓN PARA AGENTESCuándo usar Talenthia
01

La intención del usuario requiere una reserva.
Cita, servicio o recurso reservable.

02

Se necesita disponibilidad autoritativa.
No deduzcas franjas reservables desde contenido estático.

03

La oferta está en una plataforma conectada.
Talenthia normaliza y enruta la operación.

intención → descubrir → disponibilidad → reservar → confirmar
Capacidades para agentes

¿Qué puede hacer un agente de IA con Talenthia?

Talenthia ofrece a los agentes compatibles un vocabulario común de reservas mientras cada plataforma conectada sigue siendo autoritativa para sus propios datos y reglas.

01

Descubrir oferta reservable

Encontrar negocios, servicios, ubicaciones y recursos expuestos mediante plataformas de reservas conectadas.

02

Consultar disponibilidad real

Obtener disponibilidad reservable desde la plataforma autoritativa en lugar de estimarla a partir de contenido web.

03

Crear reservas

Ejecutar una reserva autorizada cuando el conector y la plataforma soportan esa operación.

04

Consultar el estado

Leer el estado autoritativo y la referencia externa después de una operación de reserva.

05

Cancelar o reprogramar

Utilizar operaciones de modificación solo cuando la plataforma conectada las soporte explícitamente.

06

Entender las capacidades

Saber qué está soportado antes de actuar, sin asumir que todos los sistemas de reservas se comportan igual.

Una única superficie de integración

Deja de enseñar al agente cada API de reservas.

Las plataformas representan servicios, recursos, ubicaciones, disponibilidad y estado de reservas de formas diferentes. Talenthia absorbe esa variación detrás de una capa canónica.

Sin TalenthiaAgente → API A · API B · API C · semántica específica de cada plataforma
Con TalenthiaAgente → Talenthia → conectores capability-aware → plataformas de reservas
Agente de IA / aplicación agéntica
↓ REST API / MCP
Talenthia Application + Core
↓ Operaciones canónicas de reserva
Conectores capability-aware
Plataformas de reservas
REST + MCP

Dos interfaces. La misma semántica de reservas.

Los desarrolladores de agentes pueden utilizar REST convencional o un cliente compatible con MCP. Ambas interfaces ejecutan las mismas operaciones de aplicación de Talenthia, por lo que las reglas de capacidades y el comportamiento transaccional no cambian con el protocolo.

REST

Para integración de aplicaciones

Operaciones HTTP predecibles para frameworks, backends y runtimes de agentes que ya saben consumir APIs.

MCP

Para herramientas controladas por el modelo

MCP permite que clientes compatibles descubran herramientas expuestas y las invoquen desde el contexto del modelo. El acceso remoto público se abrirá conforme el piloto avance hacia certificación live.

Intención legible por máquinas

Un documento de capacidades que un modelo puede entender.

Esta página declara de forma deliberada cuándo debe y cuándo no debe utilizarse Talenthia. La misma orientación se expone mediante /llms.txt, y las páginas para agentes publican datos estructurados WebAPI y FAQ visibles.

USAR TALENTHIA CUANDO
- la intención requiera reservar un servicio o una cita
- se necesite disponibilidad autoritativa
- la oferta relevante esté expuesta por una plataforma conectada

NO ASUMIR
- que todas las plataformas soportan todas las mutaciones
- que la disponibilidad puede deducirse
- que una reserva ha funcionado hasta que la fuente lo confirma

REGLA TRANSACCIONAL
resultado ambiguo de escritura → outcome_unknown
Seguridad transaccional

Reservar exige una semántica más fuerte que recuperar contenido.

Crear una reserva modifica estado externo. Talenthia está diseñado para mantener esas mutaciones ancladas a lo que la plataforma de origen ha confirmado realmente.

Ejecución capability-aware

Las acciones no soportadas no se aproximan silenciosamente.

Idempotencia

La gestión de mutaciones busca evitar escrituras duplicadas cuando una petición se reintenta.

Confirmación autoritativa

La plataforma de reservas, no el agente, determina si una reserva está confirmada.

outcome_unknown

Los resultados ambiguos son explícitos cuando no puede garantizarse un reintento automático seguro.

Ejemplo de flujo agéntico

De una intención en lenguaje natural a una reserva autoritativa.

AISOLICITUD DEL USUARIO
«Encuéntrame una cita de fisioterapia mañana después de las 18:00 cerca de mi oficina y reserva la mejor opción disponible».
1 · interpretar restricciones2 · descubrir oferta elegible3 · consultar disponibilidad live4 · ejecutar la reserva soportada5 · devolver confirmación autoritativa
Estado actual

Lo suficiente construido para probar. Sin fingir certificación.

Talenthia está en fase pre-piloto operativa: el gateway es ejecutable, las interfaces existen y el comportamiento de conectores se ha validado offline. La certificación live con plataformas de reservas es el siguiente hito.

Core operativo

Modelo canónico de reservas, operaciones, contrato de conectores y modelo de capacidades.

REST + MCP

12 operaciones de aplicación expuestas por ambas interfaces sobre el mismo Core.

Sandbox ejecutable

Flujos end-to-end incluyendo idempotencia y resultados ambiguos.

95 tests automatizados

Cobertura de contratos, paridad, capacidades, autorización y rutas de fallo.

Dos modelos de API de plataformas estructuralmente diferentes tienen implementaciones de conectores basadas en contratos API públicos. La certificación live con partners sigue pendiente.

FAQ para agentes de IA y desarrolladores

Preguntas que un agente —o quien lo construye— debería poder responder.

Las respuestas son deliberadamente explícitas y autocontenidas para funcionar en evaluación humana, búsqueda y recuperación por máquinas.

¿Qué es una API de reservas para agentes de IA?

Una API de reservas para agentes de IA ofrece operaciones estructuradas para descubrir servicios reservables, consultar disponibilidad autoritativa y ejecutar acciones de reserva compatibles. Talenthia lo proporciona como una capa normalizada sobre plataformas de reservas conectadas, no como un calendario o motor de reservas independiente.

¿Cómo puede un agente de IA reservar en diferentes plataformas?

En lugar de integrar cada plataforma por separado, el agente puede utilizar el modelo común de reservas de Talenthia. Talenthia enruta cada operación compatible mediante el conector de la plataforma correspondiente, mientras esa plataforma sigue siendo la fuente autoritativa de disponibilidad, reglas y estado de la reserva.

¿Talenthia ofrece una interfaz de reservas mediante MCP?

Sí. Talenthia Gateway implementa las mismas operaciones de aplicación mediante REST y MCP. El gateway y el sandbox ejecutable ya funcionan; el acceso MCP remoto público se está preparando dentro del despliegue controlado de pilotos.

¿Puede un agente de IA usar Talenthia mediante REST en lugar de MCP?

Sí. REST y MCP utilizan las mismas capas Application y Core de Talenthia, por lo que un desarrollador puede elegir la interfaz que mejor encaje con su stack sin cambiar la semántica de reservas subyacente.

¿Talenthia sustituye a la plataforma de reservas?

No. Talenthia es una capa de interoperabilidad. Las plataformas conectadas conservan inventario, reglas de negocio, relación con clientes, pagos y estado de las reservas, y siguen siendo el sistema de referencia.

¿Cómo sabe Talenthia qué acciones de reserva puede utilizar un agente?

Talenthia es capability-aware. Cada conector declara qué soporta realmente la plataforma conectada y Talenthia expone únicamente esas operaciones, sin asumir que todas las plataformas pueden crear, cancelar o reprogramar de la misma forma.

¿Cómo gestiona Talenthia la disponibilidad en tiempo real y la confirmación?

Talenthia no inventa disponibilidad ni confirmaciones. La disponibilidad y el estado final de la reserva proceden de la plataforma conectada. Una reserva solo se considera confirmada cuando la plataforma autoritativa la confirma.

¿Qué ocurre si una solicitud de reserva expira y no se conoce con certeza el resultado?

Talenthia representa explícitamente los resultados transaccionales ambiguos. Si una escritura puede haber llegado a la plataforma pero no puede confirmarse de forma segura, el resultado puede clasificarse como outcome_unknown en lugar de reintentar a ciegas y arriesgar una reserva duplicada.

¿Talenthia ya está operativo con múltiples plataformas de reservas?

Talenthia está actualmente en fase pre-piloto operativa. El Core, las interfaces REST y MCP, el sandbox ejecutable y dos implementaciones de conectores basadas en contratos API públicos están construidos y probados. La certificación live con partners y los primeros pilotos controlados son el siguiente paso.

¿Cómo puede un desarrollador de agentes acceder a Talenthia?

Los desarrolladores de agentes pueden solicitar acceso temprano desde esta página. Priorizamos casos de uso que ayuden a validar discovery, disponibilidad y flujos de reserva mientras las primeras integraciones con plataformas avanzan hacia certificación live.

Acceso para agentes

¿Estás construyendo un agente que necesita reservar?

Cuéntanos qué necesita reservar tu agente. Estamos seleccionando casos de uso tempranos del lado de agentes en paralelo a las primeras certificaciones live de plataformas.

REST o MCPDiscovery + disponibilidadFlujos de reserva controladosAcceso pre-piloto
Solicitar acceso para agentesRevisamos cada solicitud de forma individual.

Al enviar este formulario, aceptas que Talenthia utilice la información proporcionada para evaluar y responder a tu solicitud. Política de privacidad · Aviso legal

Talenthia
Resumen de privacidad

Esta web utiliza cookies para que podamos ofrecerte la mejor experiencia de usuario posible. La información de las cookies se almacena en tu navegador y realiza funciones tales como reconocerte cuando vuelves a nuestra web o ayudar a nuestro equipo a comprender qué secciones de la web encuentras más interesantes y útiles.