Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.olostep.com/llms.txt

Use this file to discover all available pages before exploring further.

Eliza + Olostep proporciona a tus agentes una búsqueda web confiable, permitiéndoles buscar información actual, responder preguntas abiertas con resultados en vivo y devolver enlaces deduplicados con títulos y descripciones.

Características

Acción de Búsqueda Web

Añade la acción OLOSTEP_SEARCH a los agentes de Eliza para búsqueda web en vivo.

Resultados Deduplicados

Elimina enlaces duplicados y mantiene los resultados más relevantes en la parte superior.

Configuración Sencilla

Configura una clave API en la configuración de tu agente Eliza y comienza a buscar.

Activadores en Lenguaje Natural

Funciona cuando los usuarios piden al agente buscar en la web, buscar algo o encontrar fuentes en línea.

Resultados Estructurados

Devuelve títulos, descripciones y URLs que son fáciles para que los agentes resuman o citen.

No Requiere SDK

Llama a Olostep directamente a través del endpoint /searches con fetch estándar.

Instalación

npm install @olostep/plugin-elizaos-olostep
Este paquete está publicado en npm como @olostep/plugin-elizaos-olostep.

Configuración

  1. Crea una clave API de Olostep en tu panel de control de Olostep.
  2. Añade la clave a la configuración de tu agente Eliza como OLOSTEP_API_KEY.
  3. Incluye el plugin en la configuración de tu personaje.
{
  "name": "MyAgent",
  "settings": {
    "secrets": {
      "OLOSTEP_API_KEY": "tu-clave-api-olostep-aquí"
    }
  }
}
import type { Character } from '@elizaos/core';

export const character: Character = {
  name: 'MyAgent',
  plugins: [
    '@elizaos/plugin-bootstrap',
    '@elizaos/plugin-openai',
    '@olostep/plugin-elizaos-olostep',
  ],
};

Herramientas Disponibles

Busca en la web con Olostep y devuelve una lista de enlaces relevantes con títulos y descripciones. Úsalo cuando el usuario pida al agente buscar información, investigar un tema o encontrar fuentes web actuales.
OLOSTEP_API_KEY
string
requerido
La clave API de Olostep almacenada en los secretos de tiempo de ejecución del agente.
message.content.text
string
requerido
La consulta de búsqueda. Eliza utiliza el texto del mensaje del usuario entrante como la consulta.
// Registra el plugin y deja que Eliza dirija las solicitudes de búsqueda
import type { Character } from '@elizaos/core';

export const character: Character = {
  name: 'ResearchAgent',
  plugins: ['@olostep/plugin-elizaos-olostep'],
};
La acción devuelve resultados de búsqueda estructurados en data.links, y la respuesta del agente incluye un resumen legible con hasta cinco enlaces principales.

Ejemplos Completos de Agentes

Asistente de Investigación

Un agente de investigación de propósito general que obtiene hechos recientes antes de responder:
import type { Character } from '@elizaos/core';

export const character: Character = {
  name: 'ResearchAssistant',
  bio: [
    'Responde preguntas usando fuentes web actuales.',
    'Resume enlaces en respuestas concisas y citadas.',
  ],
  plugins: [
    '@elizaos/plugin-bootstrap',
    '@elizaos/plugin-openai',
    '@olostep/plugin-elizaos-olostep',
  ],
  settings: {
    secrets: {
      OLOSTEP_API_KEY: process.env.OLOSTEP_API_KEY!,
    },
  },
};

Monitor de Noticias

Un agente que rastrea temas oportunos e informa actualizaciones notables:
import type { Character } from '@elizaos/core';

export const character: Character = {
  name: 'NewsMonitor',
  bio: ['Rastrea temas oportunos e informa actualizaciones notables desde la web.'],
  plugins: [
    '@elizaos/plugin-bootstrap',
    '@elizaos/plugin-openai',
    '@olostep/plugin-elizaos-olostep',
  ],
  style: {
    all: ['Prefiere fuentes actuales e incluye URLs directas cuando sea posible.'],
  },
};
Úsalo para alertas, tareas de vigilancia de mercado, investigación de tendencias y otros flujos de trabajo sensibles al tiempo.

Agente de Soporte con Búsqueda de Respaldo

Perfecto para responder preguntas de clientes con búsqueda de documentación de productos:
import type { Character } from '@elizaos/core';

export const character: Character = {
  name: 'SupportAgent',
  plugins: [
    '@elizaos/plugin-bootstrap',
    '@elizaos/plugin-openai',
    '@olostep/plugin-elizaos-olostep',
  ],
  topics: [
    'soporte de productos',
    'búsqueda de documentación',
    'búsqueda de notas de lanzamiento',
  ],
};
Este patrón funciona bien cuando tu agente debe buscar documentos o páginas de productos antes de responder una pregunta del cliente.

Configuración

Habilitar el plugin

Añade @olostep/plugin-elizaos-olostep al array plugins en la configuración de tu personaje.

Deshabilitar la búsqueda web

Elimina el plugin de la configuración del personaje si deseas un agente Eliza que no tenga acceso a la búsqueda de Olostep.

Usar solo algunas capacidades

Este plugin expone una sola acción, por lo que no hay un interruptor por herramienta. Controla el comportamiento a través de:
  • Qué plugins cargas en la configuración del personaje
  • Las instrucciones y estilo del agente
  • Cuándo tu tiempo de ejecución inyecta OLOSTEP_API_KEY

Características Especializadas

  • Acceso directo al endpoint /searches — el plugin llama a Olostep directamente con fetch.
  • Deduplicación de resultados — las URLs duplicadas se eliminan antes de devolver la respuesta.
  • Respuestas amigables — la acción devuelve errores claros cuando falta la clave API o la consulta está vacía.
  • Limitación de resultados principales — las respuestas se recortan a los cinco enlaces más relevantes.

Precios

El precio por el uso de búsqueda depende de tu plan de Olostep y la configuración del panel de control.
  • Consulta tu panel de control de Olostep para ver los detalles actuales de uso y facturación.
  • Revisa los límites de tu cuenta antes de implementar agentes de alto volumen.

Soporte

Recursos Relacionados

API de Búsqueda

Aprende cómo el endpoint de búsqueda devuelve resultados web

API de Lotes

Cola búsquedas y otros trabajos para flujos de trabajo más grandes

API de Respuestas

Genera salidas estilo respuesta a partir de fuentes web recuperadas

API de Rastreo

Explora colecciones de sitios más profundas y flujos de trabajo de rastreo

SDK de Python

Usa el SDK de Python para automatización personalizada alrededor de Olostep

SDK de Node.js

Construye integraciones en JavaScript y flujos de trabajo de agentes