> ## 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.

# Integración de Olostep + ElizaOS

> Añade la búsqueda web de Olostep a los agentes de Eliza con la acción `OLOSTEP_SEARCH`.

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

<CardGroup cols={2}>
  <Card title="Acción de Búsqueda Web" icon="magnifying-glass">
    Añade la acción `OLOSTEP_SEARCH` a los agentes de Eliza para búsqueda web en vivo.
  </Card>

  <Card title="Resultados Deduplicados" icon="filter">
    Elimina enlaces duplicados y mantiene los resultados más relevantes en la parte superior.
  </Card>

  <Card title="Configuración Sencilla" icon="plug">
    Configura una clave API en la configuración de tu agente Eliza y comienza a buscar.
  </Card>

  <Card title="Activadores en Lenguaje Natural" icon="message-lines">
    Funciona cuando los usuarios piden al agente buscar en la web, buscar algo o encontrar fuentes en línea.
  </Card>

  <Card title="Resultados Estructurados" icon="list-check">
    Devuelve títulos, descripciones y URLs que son fáciles para que los agentes resuman o citen.
  </Card>

  <Card title="No Requiere SDK" icon="code">
    Llama a Olostep directamente a través del endpoint `/searches` con `fetch` estándar.
  </Card>
</CardGroup>

## Instalación

<CodeGroup>
  ```bash npm theme={null}
  npm install @olostep/plugin-elizaos-olostep
  ```

  ```bash pnpm theme={null}
  pnpm add @olostep/plugin-elizaos-olostep
  ```

  ```bash bun theme={null}
  bun add @olostep/plugin-elizaos-olostep
  ```
</CodeGroup>

<Note>
  Este paquete está publicado en npm como `@olostep/plugin-elizaos-olostep`.
</Note>

## 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.

```json theme={null}
{
  "name": "MyAgent",
  "settings": {
    "secrets": {
      "OLOSTEP_API_KEY": "tu-clave-api-olostep-aquí"
    }
  }
}
```

<CodeGroup>
  ```typescript TypeScript theme={null}
  import type { Character } from '@elizaos/core';

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

  ```json JSON theme={null}
  {
    "name": "MyAgent",
    "plugins": [
      "@elizaos/plugin-bootstrap",
      "@elizaos/plugin-openai",
      "@olostep/plugin-elizaos-olostep"
    ]
  }
  ```
</CodeGroup>

## Herramientas Disponibles

### `OLOSTEP_SEARCH`

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.

<ParamField path="OLOSTEP_API_KEY" type="string" required>
  La clave API de Olostep almacenada en los secretos de tiempo de ejecución del agente.
</ParamField>

<ParamField path="message.content.text" type="string" required>
  La consulta de búsqueda. Eliza utiliza el texto del mensaje del usuario entrante como la consulta.
</ParamField>

<CodeGroup>
  ```typescript Basic Setup theme={null}
  // 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'],
  };
  ```

  ```typescript Advanced Setup theme={null}
  // Combina Olostep con un plugin de modelo para un agente de investigación completo
  import type { Character } from '@elizaos/core';

  export const character: Character = {
    name: 'ResearchAgent',
    bio: ['Investiga eventos actuales y resume fuentes web.'],
    plugins: [
      '@elizaos/plugin-bootstrap',
      '@elizaos/plugin-openai',
      '@olostep/plugin-elizaos-olostep',
    ],
  };
  ```

  ```typescript With Style Guide theme={null}
  // Adapta el agente para preferir la búsqueda web
  import type { Character } from '@elizaos/core';

  export const character: Character = {
    name: 'NewsAgent',
    style: {
      all: ['Usa la búsqueda web cuando la respuesta pueda haber cambiado recientemente.'],
    },
    plugins: ['@olostep/plugin-elizaos-olostep'],
  };
  ```
</CodeGroup>

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:

```typescript theme={null}
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:

```typescript theme={null}
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:

```typescript theme={null}
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

* **Paquete NPM**: [@olostep/plugin-elizaos-olostep](https://www.npmjs.com/package/@olostep/plugin-elizaos-olostep)
* **Sitio web de Olostep**: [olostep.com](https://www.olostep.com)
* **Panel de control de Olostep**: [dashboard.olostep.com](https://www.olostep.com/dashboard)
* **ElizaOS**: [elizaos.ai](https://elizaos.ai)
* **Soporte por correo electrónico**: [info@olostep.com](mailto:info@olostep.com)

## Recursos Relacionados

<CardGroup cols={2}>
  <Card title="API de Búsqueda" icon="magnifying-glass" href="/searches/searches">
    Aprende cómo el endpoint de búsqueda devuelve resultados web
  </Card>

  <Card title="API de Lotes" icon="layer-group" href="/features/batches/batches">
    Cola búsquedas y otros trabajos para flujos de trabajo más grandes
  </Card>

  <Card title="API de Respuestas" icon="question" href="/features/answers/answers">
    Genera salidas estilo respuesta a partir de fuentes web recuperadas
  </Card>

  <Card title="API de Rastreo" icon="spider-web" href="/features/crawls/crawls">
    Explora colecciones de sitios más profundas y flujos de trabajo de rastreo
  </Card>

  <Card title="SDK de Python" icon="python" href="/sdks/python">
    Usa el SDK de Python para automatización personalizada alrededor de Olostep
  </Card>

  <Card title="SDK de Node.js" icon="code" href="/sdks/node-js">
    Construye integraciones en JavaScript y flujos de trabajo de agentes
  </Card>
</CardGroup>