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

# Integrazione Olostep + ElizaOS

> Aggiungi la ricerca web di Olostep agli agenti Eliza con l’azione `OLOSTEP_SEARCH`.

Eliza + Olostep offre ai tuoi agenti una ricerca web affidabile, permettendo loro di cercare informazioni aggiornate, rispondere a domande aperte con risultati in tempo reale e restituire link deduplicati con titoli e descrizioni.

## Caratteristiche

<CardGroup cols={2}>
  <Card title="Azione di Ricerca Web" icon="magnifying-glass">
    Aggiunge l’azione `OLOSTEP_SEARCH` agli agenti Eliza per la ricerca web in tempo reale.
  </Card>

  <Card title="Risultati Deduplicati" icon="filter">
    Rimuove i link duplicati e mantiene i risultati più rilevanti in cima.
  </Card>

  <Card title="Configurazione Semplice" icon="plug">
    Configura una chiave API nelle impostazioni del tuo agente Eliza e inizia a cercare.
  </Card>

  <Card title="Attivazioni in Linguaggio Naturale" icon="message-lines">
    Funziona quando gli utenti chiedono all'agente di cercare sul web, cercare qualcosa o trovare fonti online.
  </Card>

  <Card title="Risultati Strutturati" icon="list-check">
    Restituisce titoli, descrizioni e URL che sono facili per gli agenti da riassumere o citare.
  </Card>

  <Card title="Nessun SDK Richiesto" icon="code">
    Chiama Olostep direttamente tramite l’endpoint `/searches` con `fetch` standard.
  </Card>
</CardGroup>

## Installazione

<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>
  Questo pacchetto è pubblicato su npm come `@olostep/plugin-elizaos-olostep`.
</Note>

## Configurazione

1. Crea una chiave API Olostep nel tuo dashboard Olostep.
2. Aggiungi la chiave alle impostazioni del tuo agente Eliza come `OLOSTEP_API_KEY`.
3. Includi il plugin nella configurazione del tuo personaggio.

```json theme={null}
{
  "name": "MyAgent",
  "settings": {
    "secrets": {
      "OLOSTEP_API_KEY": "your-olostep-api-key-here"
    }
  }
}
```

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

## Strumenti Disponibili

### `OLOSTEP_SEARCH`

Cerca sul web con Olostep e restituisce un elenco di link rilevanti con titoli e descrizioni. Usalo quando l'utente chiede all'agente di cercare informazioni, esplorare un argomento o trovare fonti web attuali.

<ParamField path="OLOSTEP_API_KEY" type="string" required>
  La chiave API Olostep memorizzata nei segreti di runtime dell'agente.
</ParamField>

<ParamField path="message.content.text" type="string" required>
  La query di ricerca. Eliza utilizza il testo del messaggio utente in arrivo come query.
</ParamField>

<CodeGroup>
  ```typescript Basic Setup theme={null}
  // Registra il plugin e lascia che Eliza instradi le richieste di ricerca
  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 modello per un agente di ricerca completo
  import type { Character } from '@elizaos/core';

  export const character: Character = {
    name: 'ResearchAgent',
    bio: ['Indaga sugli eventi attuali e riassume le fonti web.'],
    plugins: [
      '@elizaos/plugin-bootstrap',
      '@elizaos/plugin-openai',
      '@olostep/plugin-elizaos-olostep',
    ],
  };
  ```

  ```typescript With Style Guide theme={null}
  // Adatta l'agente a preferire la ricerca web
  import type { Character } from '@elizaos/core';

  export const character: Character = {
    name: 'NewsAgent',
    style: {
      all: ['Usa la ricerca web quando la risposta potrebbe essere cambiata di recente.'],
    },
    plugins: ['@olostep/plugin-elizaos-olostep'],
  };
  ```
</CodeGroup>

L'azione restituisce risultati di ricerca strutturati in `data.links`, e la risposta dell'agente include un riassunto leggibile con fino a cinque link principali.

## Esempi Completi di Agenti

### Assistente di Ricerca

Un agente di ricerca generico che recupera fatti recenti prima di rispondere:

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

export const character: Character = {
  name: 'ResearchAssistant',
  bio: [
    'Risponde alle domande utilizzando fonti web attuali.',
    'Riassume i link in risposte concise e citate.',
  ],
  plugins: [
    '@elizaos/plugin-bootstrap',
    '@elizaos/plugin-openai',
    '@olostep/plugin-elizaos-olostep',
  ],
  settings: {
    secrets: {
      OLOSTEP_API_KEY: process.env.OLOSTEP_API_KEY!,
    },
  },
};
```

### Monitor Notizie

Un agente che monitora argomenti tempestivi e riporta aggiornamenti notevoli:

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

export const character: Character = {
  name: 'NewsMonitor',
  bio: ['Monitora argomenti tempestivi e riporta aggiornamenti notevoli dal web.'],
  plugins: [
    '@elizaos/plugin-bootstrap',
    '@elizaos/plugin-openai',
    '@olostep/plugin-elizaos-olostep',
  ],
  style: {
    all: ['Preferisci fonti attuali e includi URL diretti quando possibile.'],
  },
};
```

Usa questo per avvisi, compiti di monitoraggio del mercato, ricerca di tendenze e altri flussi di lavoro sensibili al tempo.

### Agente di Supporto con Ricerca di Riserva

Perfetto per rispondere a domande dei clienti con consultazione della documentazione del prodotto:

```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: [
    'supporto prodotto',
    'consultazione documentazione',
    'ricerca note di rilascio',
  ],
};
```

Questo schema funziona bene quando il tuo agente dovrebbe cercare documenti o pagine di prodotto prima di rispondere a una domanda del cliente.

## Configurazione

### Abilita il plugin

Aggiungi `@olostep/plugin-elizaos-olostep` all'array `plugins` nella configurazione del tuo personaggio.

### Disabilita la ricerca web

Rimuovi il plugin dalla configurazione del personaggio se desideri un agente Eliza che non abbia accesso alla ricerca Olostep.

### Usa solo alcune capacità

Questo plugin espone una singola azione, quindi non c'è un interruttore per strumento. Controlla il comportamento attraverso:

* Quali plugin carichi nella configurazione del personaggio
* Le istruzioni e lo stile dell'agente
* Quando il tuo runtime inietta `OLOSTEP_API_KEY`

## Caratteristiche Specializzate

* **Accesso diretto all'endpoint `/searches`** — il plugin chiama Olostep direttamente con `fetch`.
* **Deduplicazione dei risultati** — gli URL duplicati vengono rimossi prima che la risposta venga restituita.
* **Fallback amichevoli** — l'azione restituisce errori chiari quando la chiave API manca o la query è vuota.
* **Limitazione dei risultati principali** — le risposte sono ridotte ai cinque link più rilevanti.

## Prezzi

I prezzi per l'uso della ricerca dipendono dal tuo piano Olostep e dalle impostazioni del dashboard.

* Controlla il tuo dashboard Olostep per i dettagli attuali sull'uso e la fatturazione.
* Rivedi i limiti del tuo account prima di distribuire agenti ad alto volume.

## Supporto

* **Pacchetto NPM**: [@olostep/plugin-elizaos-olostep](https://www.npmjs.com/package/@olostep/plugin-elizaos-olostep)
* **Sito Web Olostep**: [olostep.com](https://www.olostep.com)
* **Dashboard Olostep**: [dashboard.olostep.com](https://www.olostep.com/dashboard)
* **ElizaOS**: [elizaos.ai](https://elizaos.ai)
* **Supporto Email**: [info@olostep.com](mailto:info@olostep.com)

## Risorse Correlate

<CardGroup cols={2}>
  <Card title="API di Ricerca" icon="magnifying-glass" href="/searches/searches">
    Scopri come l'endpoint di ricerca restituisce risultati web
  </Card>

  <Card title="API di Batch" icon="layer-group" href="/features/batches/batches">
    Accoda ricerche e altri lavori per flussi di lavoro più grandi
  </Card>

  <Card title="API di Risposte" icon="question" href="/features/answers/answers">
    Genera output in stile risposta dalle fonti web recuperate
  </Card>

  <Card title="API di Crawl" icon="spider-web" href="/features/crawls/crawls">
    Esplora flussi di lavoro di raccolta e crawling siti più profondi
  </Card>

  <Card title="SDK Python" icon="python" href="/sdks/python">
    Usa l'SDK Python per automazione personalizzata intorno a Olostep
  </Card>

  <Card title="SDK Node.js" icon="code" href="/sdks/node-js">
    Costruisci integrazioni JavaScript e flussi di lavoro per agenti
  </Card>
</CardGroup>