Apify Actors

Apify Actors lanza en tu cuenta de Apify uno de sus robots, llamados Actors, y te devuelve los datos que recoge. En la tienda de Apify hay robots para leer el contenido de un sitio web completo, sacar los productos de una tienda online, recoger reseñas o publicaciones de redes sociales y muchas otras tareas.

Úsalo cuando necesitas datos de páginas web que no se pueden leer con una simple dirección, o cuando quieres recorrer muchas páginas de un sitio de una vez.

Cuándo usarlo

Recoger el texto de todas las páginas de la web de tu empresa para que un agente responda preguntas sobre ella.
Vigilar los precios de los productos de la competencia.
Reunir las reseñas de tu negocio publicadas en distintos sitios.
Dar a un agente la capacidad de buscar información en la web cuando la necesite.

Configuración

Necesitas una credencial Apify con el token de tu cuenta de Apify. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial Apify.
Actor (obligatorio)	El nombre del robot de Apify que quieres ejecutar, tal como aparece en la tienda de Apify. Por defecto, `apify/website-content-crawler`, que lee el contenido de un sitio web.
Run input (obligatorio)	La configuración del robot, en el formato que indica su página en la tienda de Apify. Por defecto trae un ejemplo para `apify/website-content-crawler` con la dirección por la que empezar.
Output fields	Los datos que quieres quedarte de cada resultado, separados por comas, por ejemplo `text, url`. Para un dato que está dentro de otro, usa un punto: `metadata.title`. Si lo dejas vacío, recibes todo.
Flatten output	Si lo activas, los datos que están dentro de otros pasan al primer nivel: `metadata.title` se convierte en `metadata_title`. Facilita usarlos en los componentes siguientes. Desactivado por defecto.

Resultado

El componente tiene dos salidas:

Output: la lista de resultados que ha recogido el robot, uno por elemento (por ejemplo, uno por página leída o por producto encontrado).
Tool: convierte el robot en una herramienta que un agente puede usar. El agente decide cuándo lanzarlo y con qué configuración, siguiendo la descripción del robot en Apify.

Ejemplo

Una academia quiere un asistente que conteste dudas sobre sus cursos a partir de su web.

Añade Apify Actors y elige tu credencial Apify.
Deja Actor en apify/website-content-crawler.
En Run input, cambia la dirección de ejemplo por la de la web de la academia.
En Output fields, escribe text, url para quedarte con el texto de cada página y su dirección.
Conecta la salida Output al componente que guarda los textos en una base de conocimiento, y usa esa base desde el asistente.

Buenas prácticas

Cada ejecución consume saldo de tu cuenta de Apify. Limita en Run input cuántas páginas debe recorrer el robot.
Usa Output fields para quedarte solo con lo que necesitas: los resultados de algunos robots son muy grandes.
Prueba la configuración del robot primero en la web de Apify y, cuando funcione, cópiala en Run input.