EnglishHerramientas
Tu IA elige la herramienta según lo que le pides. No tienes que nombrarlas, pero saber qué existe ayuda a pedir mejor. Las fechas van como AAAA-MM-DD; los identificadores son los de Sentir.
Siempre disponibles. No gastan tokens.
| Herramienta | Qué hace | Argumentos |
|---|---|---|
whoami |
Dice el nombre de la cuenta a la que está conectada la IA, tu rol en ella, qué puede hacer y su tope de tokens | Ninguno |
list_searches |
Tus búsquedas, de la más reciente a la más antigua, con estado y sentimiento | status (queued, running, done, failed, cancelled), limit (1 a 50, por defecto 20) |
get_search |
Una búsqueda: estado, avance, plataformas, tokens y su enlace | id |
get_report |
El reporte terminado como texto, en el idioma del reporte | id, section (summary o full) |
get_posts |
Las publicaciones leídas, con más interacción primero | id, platform, sentiment (pos, neu, neg), limit (1 a 100, por defecto 25) |
list_series |
Tus seguimientos diarios con días leídos, última lectura y tendencia | Ninguno |
get_series |
Un seguimiento: la tendencia día a día y su enlace | id |
list_comparisons |
Tus comparaciones y cara a cara, con el estado de cada lado | Ninguno |
get_comparison |
Una comparación: medidas, lectura de la IA y enlace | id |
get_tokens |
Tu saldo, el tope por búsqueda, los tokens del plan y el precio del paquete | Ninguno |
El servidor también ofrece el reporte completo como recurso: sentir://searches/{id}/report.
Las herramientas marcadas con Gasta tokens necesitan el permiso «Iniciar búsquedas» y el tope de tokens de la conexión. Un lector en la cuenta no puede usarlas: su IA solo lee.
| Herramienta | Qué hace | Argumentos | Tokens |
|---|---|---|---|
estimate_search |
Cuánto reservaría una búsqueda, si te alcanza y qué plataformas permite tu plan. No inicia nada | keyword, focus, platforms, dateFrom, dateTo, maxTokens |
No gasta |
start_search |
Inicia una búsqueda nueva | Los de arriba más acceptCut, confirm |
Gasta tokens: reserva el tope y cobra lo leído |
start_daily_tracking |
Inicia un seguimiento diario, si tu plan lo incluye | keyword, focus, platforms, startDate, endDate, maxTokens, confirm |
Gasta tokens: cada día paga lo suyo |
compare_searches |
Compara dos búsquedas terminadas | a, b, confirm |
Gasta tokens: 5 fijos; una pareja ya comparada no cobra |
share_search |
Crea un enlace para compartir un reporte terminado | id, days (1, 7, 30, 90 o 0 para nunca), allowExport |
No gasta |
La regla de confirmación
Sección titulada «La regla de confirmación»Toda herramienta que gasta tokens lleva confirm. Mientras no sea verdadero, el servidor contesta «Not started: confirm is not true» y no pasa nada. Por eso la IA te pregunta antes de empezar. Si la IA pide un maxTokens mayor que el tope de la conexión, el servidor lo rechaza y dice el tope. Si no pide ninguno, usa el menor entre el tope de tu cuenta y el de la conexión.
Límites
Sección titulada «Límites»get_reporty el recurso del reporte necesitan una búsqueda terminada. Antes, contestan con el estado.get_postsfalla si pides una plataforma que la búsqueda no leyó.compare_searchesnecesita dos búsquedas terminadas de tu cuenta.share_searchno funciona en una búsqueda en curso.