Vai al contenuto principale

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

Azione di Ricerca Web

Aggiunge l’azione OLOSTEP_SEARCH agli agenti Eliza per la ricerca web in tempo reale.

Risultati Deduplicati

Rimuove i link duplicati e mantiene i risultati più rilevanti in cima.

Configurazione Semplice

Configura una chiave API nelle impostazioni del tuo agente Eliza e inizia a cercare.

Attivazioni in Linguaggio Naturale

Funziona quando gli utenti chiedono all’agente di cercare sul web, cercare qualcosa o trovare fonti online.

Risultati Strutturati

Restituisce titoli, descrizioni e URL che sono facili per gli agenti da riassumere o citare.

Nessun SDK Richiesto

Chiama Olostep direttamente tramite l’endpoint /searches con fetch standard.

Installazione

npm install @olostep/plugin-elizaos-olostep
Questo pacchetto è pubblicato su npm come @olostep/plugin-elizaos-olostep.

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.
{
  "name": "MyAgent",
  "settings": {
    "secrets": {
      "OLOSTEP_API_KEY": "your-olostep-api-key-here"
    }
  }
}
import type { Character } from '@elizaos/core';

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

Strumenti Disponibili

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.
OLOSTEP_API_KEY
string
obbligatorio
La chiave API Olostep memorizzata nei segreti di runtime dell’agente.
message.content.text
string
obbligatorio
La query di ricerca. Eliza utilizza il testo del messaggio utente in arrivo come query.
// 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'],
};
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:
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:
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:
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

Risorse Correlate

API di Ricerca

Scopri come l’endpoint di ricerca restituisce risultati web

API di Batch

Accoda ricerche e altri lavori per flussi di lavoro più grandi

API di Risposte

Genera output in stile risposta dalle fonti web recuperate

API di Crawl

Esplora flussi di lavoro di raccolta e crawling siti più profondi

SDK Python

Usa l’SDK Python per automazione personalizzata intorno a Olostep

SDK Node.js

Costruisci integrazioni JavaScript e flussi di lavoro per agenti