Vai al contenuto principale
L’app nativa di Olostep sul Snowflake Marketplace porta i dati web in tempo reale su Snowflake. Olostep è un’infrastruttura di dati web per agenti AI e flussi di lavoro AI aziendali. Le sue API forniscono ricerca web in tempo reale, scraping e crawling per estrarre, pulire e strutturare i dati dal web. Chiama Olostep da SQL per cercare nel web, eseguire scraping delle pagine in markdown pulito, mappare e analizzare siti web, e ottenere risposte con fonti. Gli scraping e i crawling batch vengono salvati come tabelle nel tuo account, così puoi unire i dati web con i tuoi dati, caricarli in Cortex Search o usarli in Cortex Agents. Visualizza sul Snowflake Marketplace →

Prima di iniziare

  • Un account Olostep con una chiave API: ottienine una gratuita, non è richiesta la carta di credito. I tuoi primi 500 crediti sono inclusi.
  • Un account Snowflake con accesso esterno: l’app chiama l’API di Olostep tramite un’integrazione di accesso esterno, che gli account di prova non supportano.
  • Un ruolo che può approvare le connessioni dell’app: approvare la connessione a api.olostep.com richiede il privilegio MANAGE APPLICATION SPECIFICATIONS, che ACCOUNTADMIN e SECURITYADMIN hanno.

Configurazione

1

Ottieni l'app

Apri l’elenco e fai clic su Ottieni. Gli esempi in questa pagina assumono che tu la installi come olostep.
2

Approva la connessione all’API di Olostep

L’app crea la propria integrazione di accesso esterno per api.olostep.com e non può chiamare l’API finché non la approvi. In Snowsight, vai su Catalogo > App e seleziona l’app. Seleziona l’icona Impostazioni, quindi apri la scheda Configurazioni. Sotto Connessioni esterne, espandi Dettagli accanto a Integrazioni di accesso esterno e approva l’endpoint api.olostep.com.
3

Aggiungi la tua chiave API

Nella stessa scheda Configurazioni, sotto Credenziali, aggiungi un segreto GENERIC_STRING che contiene la tua chiave API dal dashboard di Olostep a Chiave API di Olostep.

Procedure

Ogni procedura restituisce un VARIANT. In caso di errore, restituisce un oggetto con status impostato su error. I limiti di velocità, gli errori del server e i timeout vengono ritentati automaticamente.

Utilizzo

Salva le pagine come tabelle

batch_scrape e crawl salvano una riga per pagina in olostep.results.<table_name>, con le colonne URL, MARKDOWN, ERROR e RETRIEVED_AT. Usare un nome di tabella esistente sostituisce quella tabella.
I batch e i crawl di solito finiscono in pochi minuti. Se uno è ancora in esecuzione dopo 20 minuti, la procedura restituisce il suo id con status impostato su in_progress. Salva le sue pagine successivamente con:
Le tabelle in results vengono rimosse se disinstalli l’app, quindi copia tutto ciò che vuoi conservare nel tuo database.

Risoluzione dei problemi

  • “Impossibile raggiungere api.olostep.com”: la connessione non è ancora approvata. Approvala come nel passaggio 2.
  • “Funzione definita dall’utente sconosciuta INTERNAL.OLOSTEP_REQUEST”: la chiave API non è ancora aggiunta. Aggiungila come nel passaggio 3.
  • HTTP 401 nell’errore: il segreto non contiene una chiave API di Olostep valida. Controllala nel dashboard di Olostep.

Risorse