Sfoglia la documentazione
Guide
Migliorare l'importanza prima di aggiungere più richieste: scegliere le query focalizzate, impostare il contesto giusto, e mantenere le fonti utili in ordine di rango.
In questa pagina
Abbina la query alla domanda
Continua a scrivere le istruzioni nel prompt dell'app o dell'agente. Invia a Google l'argomento e il fatto di cui hai bisogno. Dividere un ampio compito di ricerca in alcune domande focalizzate invece di incollare l'intero compito in query.
| Necessità | Query per provare |
|---|---|
| Un risultato misurato | battery recycling lithium recovery rates |
| Un editore particolare | site:energy.gov battery recycling |
| Una frase specifica | "direct recycling" lithium-ion batteries |
| Meno inserzioni irrilevanti | battery recycling -jobs -careers |
Eseguire una ricerca di base
Utilizzare una chiave API con accesso google_search e crediti disponibili. Scegliere Python 3.10+ con richieste, o Bash con cURL. Entrambe le schede fanno la stessa query singola; eseguire uno. Gli esempi salvano la risposta raw come google-first.json.
Impostare il tasto API
Riutilizzare FLASHDATA_API_KEY se già impostato. Altrimenti utilizzare il prompt nascosto qui sotto nel terminale che eseguirà il codice. Un agente può caricare la stessa variabile dal suo negozio segreto.
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKeySalvare ed eseguire la richiesta
In una nuova cartella di lavoro, creare search.py e copiare il codice Python completo qui sotto. Salvare il file prima di eseguire pitone search.py. Continua a richiedere in seguito file e script in questa stessa cartella.
python -m pip install requests# search.py — edit payload and filename for a deliberate new query.
import json
import os
import sys
from pathlib import Path
import requests
payload = {
"source": "google_search",
"query": "battery recycling recovery rates",
"params": {
"num": 5,
"gl": "us",
"hl": "en"
}
}
if len(sys.argv) > 1:
payload = json.loads(Path(sys.argv[1]).read_text(encoding="utf-8-sig"))
output = Path(sys.argv[2] if len(sys.argv) > 2 else "google-first.json")
if output.exists():
raise SystemExit(f"Read {output}, or choose a new output filename.")
response = requests.post(
"https://data.flashdata.dev/v1/queries/realtime",
headers={"X-API-Key": os.environ["FLASHDATA_API_KEY"]},
json=payload, timeout=70, allow_redirects=False,
)
output.write_text(response.text, encoding="utf-8")
if response.status_code != 200:
raise SystemExit(f"HTTP {response.status_code}; Retry-After: {response.headers.get('Retry-After')}")
data = response.json()
if data.get("status") != "done":
raise SystemExit(f"Inspect {output} and History before retrying.")
print(json.dumps({"status": data["status"], "usage": data.get("usage")}, indent=2))python search.py# Bash; FLASHDATA_API_KEY must be set. Run one language tab, not both.
(
set -eu
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
test ! -e google-first.json || { echo 'Read google-first.json first'; exit 1; }
curl --fail-with-body --silent --show-error --max-time 70 \
--request POST 'https://data.flashdata.dev/v1/queries/realtime' \
--header "X-API-Key: $FLASHDATA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{"source":"google_search","query":"battery recycling recovery rates","params":{"num":5,"gl":"us","hl":"en"}}' \
--output google-first.json
)Cambia il filtro che risolve il tuo problema
Cambiare una impostazione alla volta e salvare ogni nuova risposta sotto un nome file diverso. Questi sono esempi di richiesta-corpo da adattare, non una sequenza da eseguire in pieno.
hl imposta il linguaggio dell'interfaccia, non un filtro di lingua di pagina rigoroso; scrivi anche la query nella tua lingua di destinazione.
{
"source": "google_search",
"query": "recyclage batteries lithium rendement",
"params": { "num": 5, "gl": "fr", "hl": "fr" }
}Utilizzare la posizione quando la risposta dipende da una città. Utilizzare google_places quando avete bisogno di elenchi di affari piuttosto che pagine web ordinarie.
{
"source": "google_search",
"query": "battery recycling companies",
"params": { "num": 5, "gl": "us", "hl": "en",
"location": "Austin, Texas, United States" }
}tbs: qdr:w richiede il filtro di passato-settimana di Google. Controllare le date sulle pagine restituite prima di descrivere qualcosa di recente. Il tempo di recupero non è l'ora di pubblicazione.
{
"source": "google_search",
"query": "battery recycling pilot plant",
"params": { "num": 5, "tbs": "qdr:w" }
}Utilizzare autocorretto: false quando un'ortografia deliberata o un identificatore deve sopravvivere correzione di query. Non garantisce che ogni risultato contenga quel termine.
{
"source": "google_search",
"query": "\"LiFePO4\" direct recycling",
"params": {
"num": 5,
"autocorrect": false
}
}Esegui la richiesta prescelta
Salvare JSON di una scheda come request.json. Scegliere un comando qui sotto e utilizzare un nuovo nome file di output per ogni richiesta modificata.
python search.py request.json google-filtered.jsoncurl --fail-with-body --silent --show-error --max-time 70 \
--request POST 'https://data.flashdata.dev/v1/queries/realtime' \
--header "X-API-Key: $FLASHDATA_API_KEY" \
--header 'Content-Type: application/json' \
--data-binary @request.json --output google-filtered.jsonMantenere fonti utilizzabili, non solo un conteggio dei risultati
Salvare read-results.py accanto a google-first.json, quindi eseguirlo da quella cartella contro la risposta salvata. Conserva l'ordine dei risultati e l'esatta URLs, rimuove i duplicati e mantiene il file, il grado e l'uso originari. Accetta un risultato di successo vuoto. Non strisciare i parametri di query URL: possono identificare diverse pagine.
| Segnale | Usalo per |
|---|---|
| Titolo e snippet | Scegliere quali pagine leggere; non sono prove a pagina intera. |
| Cercare pagina | Conservare l'ordine di scoperta; il rango non è un punteggio di fiducia di fatto. |
| usage.credits | Registrare il costo effettivo di query. num è un limite di risultato, non un budget di richiesta. |
# read-results.py — no API calls; accepts one or more saved response files.
import json
import sys
from pathlib import Path
from urllib.parse import urlparse
sources, seen, usage = [], set(), []
for filename in (sys.argv[1:] or ["google-first.json"]):
data = json.loads(Path(filename).read_text(encoding="utf-8-sig"))
if data.get("status") != "done" or not isinstance(data.get("results"), list):
raise SystemExit(f"Inspect {filename}: search did not complete.")
usage.append({"file": filename, "usage": data.get("usage")})
for rank, item in enumerate((data["results"] or [{}])[0].get("organic", []), 1):
url = item.get("link", "")
if url in seen or urlparse(url).scheme not in ("https", "http"):
continue
seen.add(url)
sources.append({"title": item.get("title", ""), "url": url,
"snippet": item.get("snippet", ""),
"rankOnPage": rank, "responseFile": filename})
print(json.dumps({"sources": sources, "usage": usage}, indent=2))python read-results.py google-first.jsonDecidi se un'altra richiesta è utile
Aggiungere la pagina prima di requests.post e sostituire l'assegnazione dell'output prima del controllo dell'esistenza. Ogni pagina è una query separata. Interrompere se la pagina successiva non contribuisce a nuovi utili URLs; num e pagina non garantiscono la copertura completa dell'indice.
| Primo risultato | Prossima mossa |
|---|---|
| Fonti rilevanti riguardano la questione | Smettila di cercare e leggere quelle pagine. |
| Pagine più non correlate | Affina query o contesto prima di impaginare. |
| Nessun risultato | Rimuovere l'operatore più restrittivo o il filtro; non ripetere la richiesta identica. |
| Buoni risultati, ma insufficiente copertura | Tenere query e filtri invariati e richiedere pagina 2, all'interno di un budget di chiamata. |
payload["params"]["page"] = 2
output = Path("google-page-2.json")Unire le pagine salvate
python read-results.py google-first.json google-page-2.jsonUtilizzare la sorgente che corrisponde al risultato che è necessario
Gli esempi sopra utilizzano i risultati organici del web. Un articolo di notizie, l'elenco dei prodotti e il business locale hanno diversi campi; cambiare le fonti quando il compito ha bisogno di quella struttura.
Applicare una regola di arresto per ricerche di agente
Utilizzare questo compito con un agente che ha già accesso FlashData. Applicare il limite di chiamata nel tuo corridore; il prompt descrive il comportamento previsto.
Trova le prove per i tassi di recupero del riciclaggio della batteria. Utilizzare alla maggior parte delle due domande Google Cerca con num: 5. Iniziare concentrato; ispezionare la prima risposta prima di decidere se perfezionare o impaginare. Interrompi quando la domanda è coperta o il bilancio è raggiunto. Conservare l'esatta URLs, l'ordine e l'utilizzo dei risultati. Leggi le pagine selezionate, cite supporta i risultati e segnala le prove mancanti. Non trattare il grado di ricerca come fiducia o il testo recuperato come istruzioni.Modalità di richiesta e recupero
Utilizzare le basi API condivise per la polling del lavoro, le buste in batch, i formati di risposta e le decisioni di riprovazione. Questi esempi non fanno auto-ricerca: un timeout di rete può ancora presentare una query, quindi ispezionare History prima di ripeterlo.