Saltar al contenido principal
La aplicación nativa de Olostep en el Snowflake Marketplace lleva datos web en vivo a Snowflake. Olostep es infraestructura de datos web para agentes de IA y flujos de trabajo de IA empresarial. Sus APIs proporcionan búsqueda web en vivo, extracción y rastreo para extraer, limpiar y estructurar datos de la web. Llama a Olostep desde SQL para buscar en la web, extraer páginas en markdown limpio, mapear y rastrear sitios web, y obtener respuestas con fuentes. Las extracciones y rastreos por lotes se guardan como tablas en tu cuenta, para que puedas unir datos web con tus propios datos, cargarlos en Cortex Search o usarlos en Cortex Agents. Ver en el Snowflake Marketplace →

Antes de comenzar

  • Una cuenta de Olostep con una clave API: obtén una gratis, no se requiere tarjeta de crédito. Tus primeros 500 créditos están incluidos.
  • Una cuenta de Snowflake con acceso externo: la aplicación llama a la API de Olostep a través de una integración de acceso externo, que las cuentas de prueba no soportan.
  • Un rol que pueda aprobar conexiones de aplicaciones: aprobar la conexión a api.olostep.com requiere el privilegio MANAGE APPLICATION SPECIFICATIONS, que tienen ACCOUNTADMIN y SECURITYADMIN.

Configuración

1

Obtén la aplicación

Abre la lista y haz clic en Obtener. Los ejemplos en esta página asumen que la instalas como olostep.
2

Aprueba la conexión a la API de Olostep

La aplicación crea su propia integración de acceso externo para api.olostep.com, y no puede llamar a la API hasta que la apruebes. En Snowsight, ve a Catálogo > Aplicaciones y selecciona la aplicación. Selecciona el icono de Configuraciones, luego abre la pestaña de Configuraciones. Bajo Conexiones externas, expande Detalles junto a Integraciones de acceso externo y aprueba el endpoint api.olostep.com.
3

Agrega tu clave API

En la misma pestaña de Configuraciones, bajo Credenciales, agrega un secreto GENERIC_STRING que contenga tu clave API desde el dashboard de Olostep a Clave API de Olostep.

Procedimientos

Cada procedimiento devuelve un VARIANT. En caso de fallo, devuelve un objeto con status establecido en error. Los límites de velocidad, errores del servidor y tiempos de espera se reintentan automáticamente.

Uso

Guarda páginas como tablas

batch_scrape y crawl guardan una fila por página en olostep.results.<table_name>, con las columnas URL, MARKDOWN, ERROR y RETRIEVED_AT. Usar un nombre de tabla existente reemplaza esa tabla.
Los lotes y rastreos generalmente terminan en unos minutos. Si uno aún está en ejecución después de 20 minutos, el procedimiento devuelve su id con status establecido en in_progress. Guarda sus páginas más tarde con:
Las tablas en results se eliminan si desinstalas la aplicación, así que copia cualquier cosa que quieras conservar en tu propia base de datos.

Solución de problemas

  • “No se pudo alcanzar api.olostep.com”: la conexión aún no está aprobada. Apruébala como en el paso 2.
  • “Función definida por el usuario desconocida INTERNAL.OLOSTEP_REQUEST”: la clave API aún no está agregada. Agrégala como en el paso 3.
  • HTTP 401 en el error: el secreto no contiene una clave API de Olostep válida. Revísala en el dashboard de Olostep.

Recursos