Risposta rapida
Come faccio a controllare che LLMWebSearch funzioni?
Chiama GET https://llmwebsearch.com/api/v1/credits con la tua chiave. È gratuito, non tocca nessun sito web e una normale risposta JSON dimostra che l'API LLMWebSearch, la tua chiave e il tuo account funzionano. Poi esegui una ricerca, che costa 1 credito da un pack a partire da 1,20 USD/1K ricerche. Gli errori dalla nostra parte non vengono mai addebitati, e gli incidenti sono datati nel changelog.
Qual è il controllo di stato più rapido?
L'endpoint dei crediti. Risponde solo dalla nostra parte: autenticazione, API e il tuo account. Se restituisce i tuoi crediti residui, il servizio è attivo per te. Se restituisce 401, la chiave è sbagliata o revocata; creane una nuova nella dashboard.
curl -s https://llmwebsearch.com/api/v1/credits \
-H "Authorization: Bearer $LLMWEBSEARCH_API_KEY"
import os
import sys
import requests
resp = requests.get(
"https://llmwebsearch.com/api/v1/credits",
headers={"Authorization": f"Bearer {os.environ['LLMWEBSEARCH_API_KEY']}"},
timeout=10,
)
if resp.status_code != 200:
print("API check failed:", resp.status_code, resp.text[:200])
sys.exit(1)
print("API up, credits left:", resp.json()["credits_remaining"])
Come distinguo un nostro errore dal rifiuto di un sito web?
Guarda dove appare il problema nella risposta.
- Un errore HTTP sull'intera chiamata (
502 search_failed,504 search_timeout) è dalla nostra parte o a monte. Non costa nulla; aspetta un po' e riprova con un'attesa crescente. - Una chiamata riuscita con alcuni risultati privi di contenuto riguarda quelle pagine. Ogni risultato porta un
content_status:blocked_by_robots,blocked_by_site_policy,target_refused,fetch_failedofetch_timeout. La ricerca in sé ha funzionato.
Il secondo caso è normale sul web aperto e non è un incidente. La pagina degli errori elenca ogni codice.
Dove vengono registrati gli incidenti?
Nel changelog. Un incidente che coinvolge molti account riceve una voce datata: cosa è fallito, da quando a quando e cosa è cambiato dopo. Le chiamate fallite durante un incidente non sono state addebitate, quindi non c'è nulla da recuperare.
Non pubblichiamo una percentuale di uptime né un valore di latenza. Preferiamo darti un controllo che puoi eseguire piuttosto che un numero che non puoi verificare.
Cosa deve fare il mio agente quando una chiamata fallisce?
Riprova solo ciò che può riuscire più tardi. Un 429 rate_limited, 502 search_failed o 504 search_timeout merita un nuovo tentativo dopo una breve attesa che raddoppia ogni volta. Un 401 o 402 richiede una persona: una nuova chiave o più crediti. Una pagina rifiutata dal suo sito web non va ritentata affatto; usa invece gli altri risultati della stessa ricerca.
Domande sullo stato
La chiamata sui crediti consuma qualche credito?
No. GET https://llmwebsearch.com/api/v1/credits è gratuita, quindi un job di monitoraggio può eseguirla tutte le volte che il tuo limite al minuto consente.
La mia ricerca ha funzionato ma un risultato non ha contenuto. È un'interruzione del servizio?
No. Quella pagina non è stata letta: il suo content_status ne spiega il motivo. Il nostro reader rispetta robots.txt: si presenta come LLMWebSearch, segue le regole che un sito scrive per lui o per tutti i robot, e lascia fuori il contenuto di qualsiasi pagina che non gli è permesso leggere.
A chi segnalo un problema che il controllo di stato non mostra?
Al supporto a [email protected], con l'ora, l'endpoint e una risposta fallita completa. Una persona risponde entro 12 ore.