Passer au contenu principal
L’application native Olostep sur le Snowflake Marketplace intègre les données web en direct dans Snowflake. Olostep est une infrastructure de données web pour les agents IA et les flux de travail IA d’entreprise. Ses API fournissent des fonctionnalités de recherche web en direct, d’extraction et d’exploration pour extraire, nettoyer et structurer les données du web. Appelle Olostep depuis SQL pour rechercher sur le web, extraire des pages en markdown propre, mapper et explorer des sites web, et obtenir des réponses avec sources. Les extractions et explorations par lots sont enregistrées en tant que tables dans ton compte, te permettant de joindre les données web avec tes propres données, de les charger dans Cortex Search ou de les utiliser dans Cortex Agents. Voir sur le Snowflake Marketplace →

Avant de commencer

  • Un compte Olostep avec une clé API : obtiens-en une gratuitement, sans carte de crédit requise. Tes 500 premiers crédits sont inclus.
  • Un compte Snowflake avec accès externe : l’application appelle l’API Olostep via une intégration d’accès externe, que les comptes d’essai ne prennent pas en charge.
  • Un rôle pouvant approuver les connexions d’application : l’approbation de la connexion à api.olostep.com nécessite le privilège MANAGE APPLICATION SPECIFICATIONS, que ACCOUNTADMIN et SECURITYADMIN possèdent.

Configuration

1

Obtenir l'application

Ouvre la fiche et clique sur Obtenir. Les exemples sur cette page supposent que tu l’installes sous le nom olostep.
2

Approuver la connexion à l'API Olostep

L’application crée sa propre intégration d’accès externe pour api.olostep.com, et ne peut pas appeler l’API tant que tu ne l’as pas approuvée. Dans Snowsight, va à Catalogue > Applications et sélectionne l’application. Sélectionne l’icône Paramètres, puis ouvre l’onglet Configurations. Sous Connexions externes, développe Détails à côté de Intégrations d’accès externe et approuve le point de terminaison api.olostep.com.
3

Ajouter ta clé API

Dans le même onglet Configurations, sous Identifiants, ajoute un secret GENERIC_STRING qui contient ta clé API depuis le tableau de bord Olostep à Clé API Olostep.

Procédures

Chaque procédure retourne un VARIANT. En cas d’échec, elle retourne un objet avec status défini sur error. Les limites de taux, erreurs serveur et expirations sont automatiquement réessayées.

Utilisation

Enregistrer les pages en tant que tables

batch_scrape et crawl enregistrent une ligne par page dans olostep.results.<table_name>, avec les colonnes URL, MARKDOWN, ERROR et RETRIEVED_AT. Utiliser un nom de table existant remplace cette table.
Les lots et explorations se terminent généralement en quelques minutes. Si l’un d’eux est encore en cours après 20 minutes, la procédure retourne son id avec status défini sur in_progress. Enregistre ses pages plus tard avec :
Les tables dans results sont supprimées si tu désinstalles l’application, alors copie tout ce que tu veux conserver dans ta propre base de données.

Dépannage

  • “Impossible d’atteindre api.olostep.com” : la connexion n’est pas encore approuvée. Approuve-la comme à l’étape 2.
  • “Fonction définie par l’utilisateur inconnue INTERNAL.OLOSTEP_REQUEST” : la clé API n’est pas encore ajoutée. Ajoute-la comme à l’étape 3.
  • HTTP 401 dans l’erreur : le secret ne contient pas une clé API Olostep valide. Vérifie-la dans le tableau de bord Olostep.

Ressources