> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/fr/actions/workflow-concepts/workflow-steps/web-research/google-search.md).

# Recherche Google

Automatisez la recherche avec une recherche Google

L’étape « Google Search » vous permet d’automatiser une recherche Google et de transmettre les résultats en entrée dans vos Workflows.

## Configuration d’une étape « Google Search »

La configuration de l’étape est simple grâce à des menus déroulants. Aucun payload JSON requis.

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-845e09d515e04ca052ef7e25227f70228b8d1260%2FCleanShot%202025-05-26%20at%2009.07.27%402x.png?alt=media" alt=""><figcaption></figcaption></figure>

### Requête de recherche

Le champ de saisie « Requête de recherche » correspond à l’expression exacte qui sera recherchée sur Google lorsque l’étape s’exécute, c’est-à-dire que voulez-vous rechercher sur Google ?

{% hint style="info" %}
Pour rechercher sur un site spécifique, vous pouvez saisir **site:[www.example.com](http://www.example.com)** suivi de votre phrase de recherche
{% endhint %}

### Paramètres de recherche

Configurez vos paramètres de recherche à l’aide des menus déroulants :

* **Région**: Sélectionnez la région géographique pour vos résultats de recherche
* **Nombre de résultats**: Choisissez le nombre de résultats à renvoyer
* **Résultats similaires/omis**: Activez ou désactivez le filtrage

{% hint style="info" %}
**Configuration avancée :** Pour des cas d’utilisation plus complexes, vous pouvez toujours configurer des paramètres basés sur la [documentation de l’API SERP](https://serpapi.com/search-api) en utilisant le format JSON.
{% endhint %}

Pour définir dynamiquement des variables comme requête ou paramètres de recherche en faisant référence à une entrée (définie dans l’étape « Start ») ou à une variable de sortie (générée par n’importe quelle étape), vous devrez utiliser la syntaxe Liquid :

{% @arcade/embed url="<https://app.arcade.software/share/ziYB9Ed9nh8CDuLHOHcX>" flowId="ziYB9Ed9nh8CDuLHOHcX" %}

### Types de sortie

Les types de sortie suivants sont actuellement pris en charge par l’étape « Google Search » :

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-1406712bdb4b5ee66c8f624138e521ce225de7b8%2FCleanShot%202025-05-26%20at%2009.07.55%402x.png?alt=media" alt=""><figcaption></figcaption></figure>

**Liens uniquement**: Une liste de liens vers les résultats organiques.

```json
[
  "https://www.zdnet.com/article/six-skills-you-need-to-become-an-ai-prompt-engineer/",
  "https://en.wikipedia.org/wiki/Prompt_engineering",
  "https://www.mckinsey.com/featured-insights/mckinsey-explainers/what-is-prompt-engineering",
  "https://www.techtarget.com/searchenterpriseai/definition/AI-prompt-engineer",
  "https://www.datacamp.com/blog/what-is-prompt-engineering-the-future-of-ai-communication",
  "https://www.promptingguide.ai/",
  "https://aws.amazon.com/what-is/prompt-engineering/",
  "https://hbr.org/2023/06/ai-prompt-engineering-isnt-the-future",
  "https://www.iit.edu/blog/unlock-career-opportunities-ai-how-become-ai-prompt-engineer",
  "https://www.coursera.org/articles/how-to-become-a-prompt-engineer"
]
```

**Titres, extraits et liens (Markdown)**: Titres, extraits et liens pour chaque résultat organique au format Markdown.

```markdown
**Six compétences dont vous avez besoin pour devenir ingénieur de prompts en IA**
Six compétences dont vous avez besoin pour devenir ingénieur de prompts en IA · 1. Comprendre l’IA, le ML et le NLP · 2. Définir clairement les problèmes et préciser les détails ...
https://www.zdnet.com/article/six-skills-you-need-to-become-an-ai-prompt-engineer/


**Ingénierie de prompts**
L’ingénierie de prompts est le processus de structuration d’un texte pouvant être interprété et compris par un modèle d’IA générative. ... Un prompt est un texte en langage naturel ...
https://en.wikipedia.org/wiki/Prompt_engineering


**Qu’est-ce que l’ingénierie de prompts ?**
L’ingénierie de prompts est la pratique consistant à concevoir des entrées pour des outils d’IA générative afin de produire des résultats optimaux.
https://www.mckinsey.com/featured-insights/mckinsey-explainers/what-is-prompt-engineering

...

```

**Résultats organiques (JSON)**: Résultats organiques au format JSON.

```
[
  {
    "position": 1,
    "title": "Six compétences dont vous avez besoin pour devenir ingénieur de prompts en IA",
    "link": "https://www.zdnet.com/article/six-skills-you-need-to-become-an-ai-prompt-engineer/",
    "displayed_link": "https://www.zdnet.com › ... › Intelligence artificielle",
    "favicon": "https://serpapi.com/searches/65579a96e815af000b7dab68/images/a5422e713e6bc3f59a76b766eb80117740cc3058315f42d3df7f4337510ce3b6.png",
    "date": "3 oct. 2023",
    "snippet": "Six compétences dont vous avez besoin pour devenir ingénieur de prompts en IA · 1. Comprendre l’IA, le ML et le NLP · 2. Définir clairement les problèmes et préciser les détails ...",
    "snippet_highlighted_words": [
      "ingénieur de prompts"
    ],
    "about_page_link": "https://www.google.com/search?q=About+https://www.zdnet.com/article/six-skills-you-need-to-become-an-ai-prompt-engineer/&tbm=ilp",
    "about_page_serpapi_link": "https://serpapi.com/search.json?engine=google_about_this_result&google_domain=google.com&q=About+https%3A%2F%2Fwww.zdnet.com%2Farticle%2Fsix-skills-you-need-to-become-an-ai-prompt-engineer%2F",
    "cached_page_link": "https://webcache.googleusercontent.com/search?q=cache:QnozTEs7HoMJ:https://www.zdnet.com/article/six-skills-you-need-to-become-an-ai-prompt-engineer/&hl=en&gl=us",
    "source": "ZDNet"
  },
  ...
]
```

**Brut**: Résultats complets de l’API Serp au format JSON.

```
{
  "search_metadata": {
    "id": "65ad949daf5af14fb1f744b3",
    "status": "Succès",
    "json_endpoint": "https://serpapi.com/searches/c058cc17ce2a376c/65ad949daf5af14fb1f744b3.json",
    "created_at": "2024-01-21 22:03:09 UTC",
    "processed_at": "2024-01-21 22:03:09 UTC",
    "google_url": "https://www.google.com/search?q=How+does+an+LLM+work%3F%0A%0A&oq=How+does+an+LLM+work%3F%0A%0A&num=1&sourceid=chrome&ie=UTF-8",
    "raw_html_file": "https://serpapi.com/searches/c058cc17ce2a376c/65ad949daf5af14fb1f744b3.html",
    "total_time_taken": 2.5
  },
  "search_parameters": {
    "engine": "google",
    "q": "Comment fonctionne un LLM ?\n\n",
    "google_domain": "google.com",
    "num": "1",
    "device": "desktop"
  },
  ...
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/fr/actions/workflow-concepts/workflow-steps/web-research/google-search.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
