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

# Olostep + ElizaOS Integratie

> Voeg Olostep webzoekfunctie toe aan Eliza-agenten met de `OLOSTEP_SEARCH` actie.

Eliza + Olostep biedt je agenten betrouwbare webzoekmogelijkheden, waardoor ze actuele informatie kunnen opzoeken, open vragen kunnen beantwoorden met live resultaten, en gededupliceerde links met titels en beschrijvingen kunnen retourneren.

## Functies

<CardGroup cols={2}>
  <Card title="Webzoekactie" icon="magnifying-glass">
    Voegt de `OLOSTEP_SEARCH` actie toe aan Eliza-agenten voor live webzoekopdrachten.
  </Card>

  <Card title="Gedupliceerde Resultaten" icon="filter">
    Verwijdert dubbele links en houdt de meest relevante resultaten bovenaan.
  </Card>

  <Card title="Eenvoudige Installatie" icon="plug">
    Configureer één API-sleutel in je Eliza-agentinstellingen en begin met zoeken.
  </Card>

  <Card title="Natuurlijke Taal Triggers" icon="message-lines">
    Werkt wanneer gebruikers de agent vragen om op het web te zoeken, iets op te zoeken, of online bronnen te vinden.
  </Card>

  <Card title="Gestructureerde Resultaten" icon="list-check">
    Retourneert titels, beschrijvingen en URL's die gemakkelijk zijn voor agenten om samen te vatten of te citeren.
  </Card>

  <Card title="Geen SDK Vereist" icon="code">
    Roept Olostep direct aan via de `/searches` endpoint met standaard `fetch`.
  </Card>
</CardGroup>

## Installatie

<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>
  Dit pakket is gepubliceerd op npm als `@olostep/plugin-elizaos-olostep`.
</Note>

## Configuratie

1. Maak een Olostep API-sleutel aan in je Olostep-dashboard.
2. Voeg de sleutel toe aan je Eliza-agentinstellingen als `OLOSTEP_API_KEY`.
3. Voeg de plugin toe aan je karakterconfiguratie.

```json theme={null}
{
  "name": "MyAgent",
  "settings": {
    "secrets": {
      "OLOSTEP_API_KEY": "je-olostep-api-sleutel-hier"
    }
  }
}
```

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

## Beschikbare Tools

### `OLOSTEP_SEARCH`

Doorzoekt het web met Olostep en retourneert een lijst van relevante links met titels en beschrijvingen. Gebruik het wanneer de gebruiker de agent vraagt om informatie te zoeken, een onderwerp op te zoeken, of actuele webbronnen te vinden.

<ParamField path="OLOSTEP_API_KEY" type="string" required>
  De Olostep API-sleutel opgeslagen in de agent runtime secrets.
</ParamField>

<ParamField path="message.content.text" type="string" required>
  De zoekopdracht. Eliza gebruikt de binnenkomende gebruikersberichttekst als de zoekopdracht.
</ParamField>

<CodeGroup>
  ```typescript Basic Setup theme={null}
  // Registreer de plugin en laat Eliza zoekverzoeken routeren
  import type { Character } from '@elizaos/core';

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

  ```typescript Advanced Setup theme={null}
  // Combineer Olostep met een modelplugin voor een volledige onderzoeksagent
  import type { Character } from '@elizaos/core';

  export const character: Character = {
    name: 'ResearchAgent',
    bio: ['Onderzoekt actuele gebeurtenissen en vat webbronnen samen.'],
    plugins: [
      '@elizaos/plugin-bootstrap',
      '@elizaos/plugin-openai',
      '@olostep/plugin-elizaos-olostep',
    ],
  };
  ```

  ```typescript With Style Guide theme={null}
  // Pas de agent aan om webzoekopdrachten te prefereren
  import type { Character } from '@elizaos/core';

  export const character: Character = {
    name: 'NewsAgent',
    style: {
      all: ['Gebruik webzoekopdrachten wanneer het antwoord recent kan zijn veranderd.'],
    },
    plugins: ['@olostep/plugin-elizaos-olostep'],
  };
  ```
</CodeGroup>

De actie retourneert gestructureerde zoekresultaten in `data.links`, en de agentrespons bevat een leesbare samenvatting met maximaal vijf top links.

## Volledige Agent Voorbeelden

### Onderzoeksassistent

Een algemene onderzoeksagent die recente feiten ophaalt voordat hij antwoordt:

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

export const character: Character = {
  name: 'ResearchAssistant',
  bio: [
    'Beantwoordt vragen met behulp van actuele webbronnen.',
    'Vat links samen in beknopte, geciteerde antwoorden.',
  ],
  plugins: [
    '@elizaos/plugin-bootstrap',
    '@elizaos/plugin-openai',
    '@olostep/plugin-elizaos-olostep',
  ],
  settings: {
    secrets: {
      OLOSTEP_API_KEY: process.env.OLOSTEP_API_KEY!,
    },
  },
};
```

### Nieuwsmonitor

Een agent die actuele onderwerpen volgt en opmerkelijke updates rapporteert:

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

export const character: Character = {
  name: 'NewsMonitor',
  bio: ['Volgt actuele onderwerpen en rapporteert opmerkelijke updates van het web.'],
  plugins: [
    '@elizaos/plugin-bootstrap',
    '@elizaos/plugin-openai',
    '@olostep/plugin-elizaos-olostep',
  ],
  style: {
    all: ['Geef de voorkeur aan actuele bronnen en voeg directe URL's toe wanneer mogelijk.'],
  },
};
```

Gebruik dit voor waarschuwingen, marktwaarnemingstaken, trendonderzoek en andere tijdgevoelige workflows.

### Support Agent met Zoekterugval

Perfect voor het beantwoorden van klantvragen met productdocumentatie opzoekfunctie:

```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: [
    'productondersteuning',
    'documentatie opzoeken',
    'release notes zoeken',
  ],
};
```

Dit patroon werkt goed wanneer je agent documentatie of productpagina's moet doorzoeken voordat hij een klantvraag beantwoordt.

## Configuratie

### Activeer de plugin

Voeg `@olostep/plugin-elizaos-olostep` toe aan de `plugins` array in je karakterconfiguratie.

### Schakel webzoekfunctie uit

Verwijder de plugin uit de karakterconfiguratie als je een Eliza-agent wilt die geen toegang heeft tot Olostep-zoekfunctie.

### Gebruik slechts enkele mogelijkheden

Deze plugin biedt een enkele actie, dus er is geen per-tool schakelaar. Beheer gedrag via:

* Welke plugins je laadt in de karakterconfiguratie
* De agentinstructies en stijl
* Wanneer je runtime `OLOSTEP_API_KEY` injecteert

## Gespecialiseerde Functies

* **Directe toegang tot `/searches` endpoint** — de plugin roept Olostep direct aan met `fetch`.
* **Resultaatdeduplicatie** — dubbele URL's worden verwijderd voordat de respons wordt geretourneerd.
* **Vriendelijke terugvallen** — de actie retourneert duidelijke fouten wanneer de API-sleutel ontbreekt of de zoekopdracht leeg is.
* **Topresultaatbeperking** — reacties worden beperkt tot de vijf meest relevante links.

## Prijzen

De prijs voor zoekgebruik hangt af van je Olostep-plan en dashboardinstellingen.

* Controleer je Olostep-dashboard voor actuele gebruiks- en factureringsdetails.
* Bekijk je accountlimieten voordat je agenten met een hoog volume inzet.

## Ondersteuning

* **NPM Pakket**: [@olostep/plugin-elizaos-olostep](https://www.npmjs.com/package/@olostep/plugin-elizaos-olostep)
* **Olostep Website**: [olostep.com](https://www.olostep.com)
* **Olostep Dashboard**: [dashboard.olostep.com](https://www.olostep.com/dashboard)
* **ElizaOS**: [elizaos.ai](https://elizaos.ai)
* **E-mail Ondersteuning**: [info@olostep.com](mailto:info@olostep.com)

## Gerelateerde Bronnen

<CardGroup cols={2}>
  <Card title="Zoek-API" icon="magnifying-glass" href="/searches/searches">
    Leer hoe de zoekendpoint webresultaten retourneert
  </Card>

  <Card title="Batches API" icon="layer-group" href="/features/batches/batches">
    Wachtrij zoekopdrachten en andere taken voor grotere workflows
  </Card>

  <Card title="Antwoorden API" icon="question" href="/features/answers/answers">
    Genereer antwoordstijl outputs van opgehaalde webbronnen
  </Card>

  <Card title="Crawls API" icon="spider-web" href="/features/crawls/crawls">
    Verken diepere siteverzameling en crawlworkflows
  </Card>

  <Card title="Python SDK" icon="python" href="/sdks/python">
    Gebruik de Python SDK voor aangepaste automatisering rond Olostep
  </Card>

  <Card title="Node.js SDK" icon="code" href="/sdks/node-js">
    Bouw JavaScript-integraties en agentworkflows
  </Card>
</CardGroup>