Resumen
¡Bienvenido a la documentación de la API de Tess AI! Esta guía te ayudará a comenzar con nuestra API y entender cómo integrar las poderosas capacidades de Tess AI en tus aplicaciones.
URL Base
Todas las solicitudes de API deben hacerse a la siguiente URL base:
https://api.tess.im
Autenticación
Todas las solicitudes de API requieren autenticación usando una clave de API. Puedes obtener tu clave de API desde el Panel de Tess AI.
Para autenticar tus solicitudes, incluye tu clave de API en el encabezado Authorization:
Authorization: Bearer YOUR_API_KEY
Endpoints de la API
La API de Tess AI proporciona las siguientes categorías principales de endpoints:
Agentes
| Endpoint | Método | Descripción | Documentación |
|---|---|---|---|
/agents | GET | Listar todos los agentes | Listar Agentes |
/agents/{id} | GET | Obtener un agente específico | Obtener Agente |
/agents/{id}/execute | POST | Ejecutar un agente | Ejecutar Agente |
/agent-responses/{id} | GET | Obtener respuesta de ejecución del agente | Obtener Respuesta del Agente |
Archivos del Agente
| Endpoint | Método | Descripción | Documentación |
|---|---|---|---|
/agents/{agentId}/files | GET | Listar archivos del agente | Listar Archivos del Agente |
/agents/{agentId}/files | POST | Vincular archivos al agente | Vincular Archivos al Agente |
/agents/{agentId}/files/{fileId} | DELETE | Eliminar archivo del agente | Eliminar Archivo del Agente |
Webhooks del Agente
| Endpoint | Método | Descripción | Documentación |
|---|---|---|---|
/agents/{id}/webhooks | GET | Listar webhooks del agente | Listar Webhooks del Agente |
/agents/{id}/webhooks | POST | Crear webhook del agente | Crear Webhook del Agente |
Memorias
| Endpoint | Método | Descripción | Documentación |
|---|---|---|---|
/memories | GET | Listar todas las memorias | Listar Memorias |
/memories | POST | Crear una memoria | Crear Memoria |
/memories/{memoryId} | PATCH | Actualizar una memoria | Actualizar Memoria |
/memories/{memoryId} | DELETE | Eliminar una memoria | Eliminar Memoria |
Colecciones de Memoria
| Endpoint | Método | Descripción | Documentación |
|---|---|---|---|
/memory-collections | GET | Listar todas las colecciones | Listar Colecciones |
/memory-collections | POST | Crear una colección | Crear Colección |
/memory-collections/{collection_id} | PUT | Actualizar una colección | Actualizar Colección |
/memory-collections/{collection_id} | DELETE | Eliminar una colección | Eliminar Colección |
Archivos
| Endpoint | Método | Descripción | Documentación |
|---|---|---|---|
/files | GET | Listar todos los archivos | Listar Archivos |
/files | POST | Subir un archivo | Subir Archivo |
/files/{fileId} | GET | Obtener detalles del archivo | Obtener Archivo |
/files/{fileId} | DELETE | Eliminar un archivo | Eliminar Archivo |
/files/{fileId}/process | POST | Procesar un archivo | Procesar Archivo |
Webhooks
| Endpoint | Método | Descripción | Documentación |
|---|---|---|---|
/webhooks | GET | Listar todos los webhooks | Listar Webhooks |
/webhooks/{id} | DELETE | Eliminar un webhook | Eliminar Webhook |
Formato de Solicitud
La mayoría de los endpoints de la API aceptan cuerpos de solicitud codificados en JSON. Asegúrate de incluir el siguiente encabezado en tus solicitudes:
Content-Type: application/json
Formato de Respuesta
Todas las respuestas de la API se devuelven en formato JSON. Una respuesta exitosa normalmente tendrá un código de estado HTTP 2xx y contendrá los datos solicitados. Las respuestas de error tendrán un código de estado 4xx o 5xx e incluirán un mensaje de error.