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

# API degli Agenti

> Crea agenti di ricerca senza codice che cercano, estraggono e navigano il web con Olostep.

Attraverso l'API degli Agenti di Olostep puoi creare agenti di ricerca autonomi che possono automatizzare pipeline di dati e compiti di ricerca secondo un programma e fornire risultati strutturati.

* Ricerca web su siti con estrazione automatizzata
* Flussi di lavoro multi-step con esecuzione programmata e notifiche
* Output in JSON/CSV/Sheets/DB

Per disponibilità e dettagli, contattaci a [info@olostep.com](mailto:info@olostep.com) o [Contatta il reparto vendite](https://www.olostep.com/contact-sales).

## Installazione

<CodeGroup>
  ```python Python theme={null}
  # pip install requests

  import requests
  ```

  ```js Node theme={null}
  // npm install node-fetch

  // ESM
  import fetch from 'node-fetch'

  // CommonJS
  const fetch = require('node-fetch')
  ```

  ```bash cURL theme={null}
  # macOS: il curl integrato va bene
  ```
</CodeGroup>

## Crea un agente

Crea un agente con un prompt in linguaggio naturale e un modello di destinazione.

<CodeGroup>
  ```python Python theme={null}
  API_URL = 'https://api.olostep.com/v1/agents' # endpoint disponibile per clienti selezionati
  API_KEY = '<YOUR_API_KEY>'

  headers = {
    'Authorization': f'Bearer {API_KEY}', 
    'Content-Type': 'application/json'
  }

  data = {
    "prompt": """
      Trova le aziende del portafoglio da https://www.vcsheet.com/funds e 
      scrivi su un Google Sheet con colonne (Nome del Fondo, URL del sito web del Fondo, 
      URL LinkedIn del Fondo, Nome dell'Azienda del Portafoglio, URL dell'Azienda del Portafoglio, 
      URL LinkedIn dell'Azienda del Portafoglio). Esegui settimanalmente il lunedì alle 9:00 AM 
      e invia un'email a steve@example.com quando vengono aggiunte nuove aziende.
    """,
    "model": "gpt-4.1"
  }

  response = requests.post(API_URL, headers=headers, json=data)
  result = response.json()
  print(result)
  ```

  ```js Node theme={null}
  const res = await fetch('https://api.olostep.com/v1/agents', {
    method: 'POST',
    headers: { 'Authorization': 'Bearer <YOUR_API_KEY>', 'Content-Type': 'application/json' },
    body: JSON.stringify({
      prompt: 'Trova le aziende del portafoglio da https://www.vcsheet.com/funds e scrivi su un Google Sheet...',
      model: 'gpt-4.1'
    })
  })
  console.log(await res.json())
  ```

  ```bash cURL theme={null}
  curl -s -X POST "https://api.olostep.com/v1/agents" \
    -H "Authorization: Bearer $OLOSTEP_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "prompt": "Trova le aziende del portafoglio da https://www.vcsheet.com/funds e scrivi su un Google Sheet...",
      "model": "gpt-4.1"
    }'
  ```
</CodeGroup>

## Capacità

L'agente Olostep può:

* **Ricerca Web**: Cercare ed estrarre automaticamente dati dai siti web
* **Organizzazione dei Dati**: Strutturare le informazioni in fogli di calcolo, database o altri formati
* **Esecuzione Programmata**: Eseguire compiti su un programma ricorrente (giornaliero, settimanale, a un orario predefinito)
* **Flussi di Lavoro Multi-step**: Svolgere compiti di ricerca complessi e multipart autonomamente
* **Notifiche**: Inviare avvisi email quando vengono trovati nuovi dati o i compiti sono completati
* **Output Personalizzato**: Restituire dati come CSV, JSON, Google Sheet, o direttamente nel tuo database

## Accesso

L'API degli Agenti è attualmente disponibile per clienti selezionati. Per ottenere l'accesso:

* Inviaci un'email a [info@olostep.com](mailto:info@olostep.com)
* Oppure [contatta il nostro team di vendita](https://www.olostep.com/contact-sales)

## Prezzi

Il prezzo degli agenti è variabile. Viene fatturato in base al risultato. Il prezzo è negoziato tra il cliente e l'agente. Contatta [info@olostep.com](mailto:info@olostep.com) per maggiori dettagli.