Sabemos que, al explorar una plataforma innovadora como la nuestra, pueden surgir dudas y retos. Por eso, reunimos algunas preguntas hechas recientemente por nuestros clientes y colaboradores, y preparamos una guía con explicaciones claras y soluciones prácticas. Nuestro objetivo es asegurarnos de que aproveches al máximo todos los recursos de Tess AI.
El mundo de las APIs puede parecer un laberinto, ¡pero estamos aquí para hacerlo fácil!
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 te permite:
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 apps e integraciones con Tess AI que se ajusten a tus necesidades específicas.
Para empezar 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 tus peticiones. La URL base de Tess AI es: tess.pareto.io (o similar, revisa la documentación más reciente). Importante: Asegúrate de usar la URL base de Tess AI y no la de OpenAI ni de otros servicios de IA.
Endpoints: Son "direcciones" específicas dentro de la API que te dejan hacer acciones distintas. Cada endpoint se encarga de una operación concreta, como:
GET /templates: Para conseguir una lista de plantillas.
POST /agents: Para ejecutar un agente.
POST /chat/completions: Para iniciar una conversación de chat con un modelo.
GET /users/me: Para conseguir los datos del usuario autenticado.
¡Y mucho más! Mira la documentación de la API para ver la lista completa.
Métodos HTTP: Son acciones que puedes hacer en un endpoint. Los más comunes son:
GET: Para conseguir información.
POST: Para mandar datos y crear o actualizar recursos.
PUT: Para actualizar recursos existentes.
DELETE: Para borrar recursos.
Autenticación: Para usar la API necesitas un token de autenticación (API Key). Se usa para identificarte y autorizar tus peticiones. Puedes conseguir tu token en la plataforma de Tess AI, en la configuración de tu usuario.
Formato de Datos: Normalmente, los datos se mandan y se reciben en formato JSON (JavaScript Object Notation), un formato ligero y fácil de procesar.
Root IDs para Conversaciones: Usa el root_id para mantener el historial de tus conversaciones. Si no incluyes un root_id en una nueva solicitud, se iniciará una conversación nueva. 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. Revisa tu consumo y optimiza tus llamadas.
La API también ofrece funcionalidades para:
Crear, ejecutar y gestionar agentes: Usa el endpoint /Agents para crear, obtener, actualizar o borrar tus plantillas.
Ejecutar y gestionar agentes: Usa el endpoint /Agent Files para gestionar los datos de nutrición de tus agentes
Error de Autenticación (401): Verifica si tu token de API es correcto y si lo estás incluyendo en el encabezado de tu solicitud (normalmente en el encabezado Authorization: Bearer <seu_token>).
Error de Endpoint No Encontrado (404): Verifica si el endpoint que estás usando es correcto y si estás utilizando el método HTTP adecuado.
Error de Formato de Datos (400): Verifica si estás enviando los datos en el formato correcto (normalmente JSON) y si todos los campos obligatorios están completos.
Error de Límite de Solicitudes (429): Si te aparece este error, estás haciendo demasiadas solicitudes en poco tiempo. Intenta reducir la frecuencia de tus solicitudes o pon un mecanismo de retry.
Mantente al día:
La API de Tess AI puede cambiar. Revisa siempre la documentación más reciente.
Siempre estamos trabajando para mejorar nuestra API y ofrecer nuevas funciones a nuestros desarrolladores. ¡Estate atento a nuestra documentación y novedades!
¡Dejamos este artículo listo 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 crear soluciones innovadoras y expandir las capacidades de nuestra plataforma. Usa la documentación, explora los endpoints, sigue los consejos que listamos aquí y empieza 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
