Sabemos que, al explorar una plataforma innovadora como la nuestra, pueden surgir dudas y desafíos. Por eso, hemos reunido algunas preguntas planteadas recientemente por nuestros clientes y colaboradores, y hemos preparado una guía con explicaciones claras y soluciones prácticas. Nuestro objetivo es garantizar que aproveches al máximo todos los recursos de Tess AI.
¡El universo de las API puede parecer un laberinto, pero estamos aquí para simplificarlo!
Puedes acceder a la documentación de la API de Pareto en este enlace aquí
API, o Interfaz de Programación de Aplicaciones, es un conjunto de reglas que permite que diferentes softwares se comuniquen entre sí. En Tess AI, la API permite que tú:
Accede a recursos: Utiliza nuestros modelos de IA, crea agentes, gestiona tus agentes y mucho más.
Automatiza tareas: Integra Tess AI en tus flujos de trabajo y automatiza procesos.
Crea soluciones personalizadas: Desarrolla aplicaciones e integraciones con Tess AI que respondan a tus necesidades específicas.
Para comenzar a usar nuestra API, es importante entender algunos conceptos básicos:
URL Base: Es la dirección principal de la API, la base para todas sus solicitudes. La URL base de Tess AI es: tess.pareto.io
(o similar, consulte la documentación más reciente). Importante: Asegúrese de usar la URL base de Tess AI y no la de OpenAI u otros servicios de IA.
Endpoints: Son "direcciones" específicas dentro de la API que permiten realizar acciones distintas. Cada endpoint es responsable de una operación específica, como:
GET /templates
: Para obtener una lista de templates.
POST /agents
: Para ejecutar un agente.
POST /chat/completions
: Para iniciar una conversación de chat con un modelo.
GET /users/me
: Para obtener datos del usuario autenticado.
¡Y mucho más! Consulte la documentación de la API para la lista completa.
Métodos HTTP: Son acciones que puedes realizar en un endpoint. Los más comunes son:
GET
: Para obtener información.
POST
: Para enviar datos y crear o actualizar recursos.
PUT
: Para actualizar recursos existentes.
DELETE
: Para eliminar recursos.
Autenticación: Para usar la API, necesitarás un token de autenticación (API Key). Se utiliza para identificar y autorizar tus solicitudes. Puedes obtener tu token en la plataforma Tess AI, en la configuración de tu usuario.
Formato de Datos: Generalmente, los datos se envían y reciben en formato JSON (JavaScript Object Notation), un formato ligero y fácil de procesar.
Root IDs para Conversaciones: Use el root_id
para mantener el historial de tus conversaciones. Si no incluyes un root_id
en una nueva solicitud, se iniciará una nueva conversación. La respuesta del endpoint siempre devuelve un root_id
.
Modelos: Consulta la documentación para ver qué modelos están disponibles y cuáles son sus funcionalidades.
Consumo de Tokens: Recuerda que cada solicitud usa tokens. Monitorea tu consumo y optimiza tus llamadas.
La API también ofrece funcionalidades para:
Crear, ejecutar y gestionar agentes: Use el endpoint /Agents
para crear, obtener, actualizar o eliminar sus plantillas.
Ejecutar y gestionar agentes: Use el endpoint /Agent Files
para gestionar los datos de nutrición de sus agentes
Error de Autenticación (401): Verifique si su token de API es correcto y si lo está incluyendo en el encabezado de su solicitud (generalmente en el encabezado Authorization: Bearer <su_token>
).
Error de Endpoint No Encontrado (404): Verifique si el endpoint que está utilizando es correcto y si está utilizando el método HTTP adecuado.
Error de Formato de Datos (400): Verifique si está enviando los datos en el formato correcto (generalmente JSON) y si todos los campos obligatorios están llenos.
Error de Límite de Solicitudes (429): Si está recibiendo este error, está realizando demasiadas solicitudes en un corto período de tiempo. Intente reducir la frecuencia de sus solicitudes o implementar un mecanismo de retry.
Manténgase al día:
La API de Tess AI puede sufrir modificaciones. Consulte siempre la documentación más reciente.
Siempre estamos trabajando para mejorar nuestra API y ofrecer nuevas funcionalidades a nuestros desarrolladores. ¡Mantente atento a nuestra documentación y novedades!
¡Hemos preparado este artículo para que puedas analizar cómo cada modelo puede gastar créditos en Tess AI!
La API de Tess AI es una herramienta poderosa que te permite construir soluciones innovadoras y expandir las capacidades de nuestra plataforma. Usa la documentación, explora los endpoints, sigue los consejos que listamos aquí y comienza a transformar tus ideas en realidad.
Si tienes alguna duda o necesitas ayuda, no dudes en ponerte en contacto con nuestro equipo de soporte.
¡Hasta la próxima!
Equipo Tess AI