# Outils

> Appeler un à un les outils des agents, avec leurs scopes et leurs entrées.

Source: https://piqline.com/fr/docs/api/tools

Les agents de Piqline travaillent avec des outils : lire le corpus, chercher en direct, écrire, agir. L’API expose chacun d’eux sous la même forme. 92 outils sont appelables ; le [catalogue](#catalogue) les liste avec leurs scopes, et la [référence](/fr/docs/api/reference) décrit les paramètres de chacun, avec des exemples d’appel.

## Lister les outils

```http
GET https://piqline.com/api/v1/tools
GET https://piqline.com/api/v1/tools?agent=linkedin
GET https://piqline.com/api/v1/tools/{nom}
```

`agent` accepte `all` (par défaut), `piqline`, `requete`, `facebook`, `linkedin`, `upwork` ou `onboarding`. Chaque outil de la liste porte :

| Champ | Sens |
| --- | --- |
| `name` | nom de l’outil, tel qu’on l’appelle |
| `description` | ce que l’outil fait, en anglais, telle que l’agent la lit |
| `agents` | agents qui disposent de l’outil |
| `requires` | scopes exigés |
| `callable` | `true` si votre clé peut l’appeler |
| `missing_scopes` | scopes que la clé n’a pas |
| `confirmation_in_chat` | `true` si le chat demande une confirmation avant l’outil |
| `read_only` | `true` si l’outil ne modifie rien |
| `input_schema` | JSON Schema de l’entrée |

Les outils que votre clé ne peut pas appeler restent listés, avec `callable: false` et `missing_scopes`. `GET /api/v1/tools/{nom}` renvoie la même fiche pour un seul outil, sans `confirmation_in_chat` ni `read_only`.

## Appeler un outil

```http
POST https://piqline.com/api/v1/tools/{nom}
Content-Type: application/json
```

Le corps JSON est l’entrée de l’outil, telle que `input_schema` la décrit. Un outil sans entrée accepte un corps vide.

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/searchItems \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"levée de fonds","limit":5}'
```
```javascript tab="JavaScript"
const response = await fetch("https://piqline.com/api/v1/tools/searchItems", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ query: "levée de fonds", limit: 5 }),
});
const data = await response.json();
```
```python tab="Python"
import os
import requests

response = requests.post(
    "https://piqline.com/api/v1/tools/searchItems",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={"query": "levée de fonds", "limit": 5},
)
data = response.json()
```

La réponse porte le nom de l’outil et sa sortie, qui est celle que l’agent lit :

```json
{
  "tool": "searchItems",
  "output": {
    "count": 1,
    "hasMore": true,
    "items": [
      {
        "id": "5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70",
        "sourceId": "e1f4b2a8-6c3d-4957-b0a1-82d5c7f3e964",
        "title": "Titre de l’article",
        "excerpt": "Début du texte…",
        "itemType": "article",
        "platform": "rss",
        "sourceName": "Blog du secteur",
        "sourceBadge": null,
        "occurredAt": "2026-10-27T08:14:00.000+00:00",
        "url": "https://exemple.fr/article",
        "language": "fr"
      }
    ]
  }
}
```

`occurredAt` est la date d’affichage de l’item. `getItem` donne en plus `detectedAt` (la première observation par Piqline), `lastSeenAt` (la dernière vue) et `publishedAt`.

Une erreur revient en `application/problem+json` : voir [Erreurs](/fr/docs/api/errors).

## Qui peut appeler quoi

- **Le rôle du créateur borne la clé.** Un outil que ce rôle n’ouvre pas répond `403 forbidden`. Les outils d’écriture, les outils d’action et l’agent `onboarding` sont réservés aux owners et aux admins.
- **Les cartes du chat n’existent pas en API.** `askUser`, `proposeSources`, `proposeBoard` et leurs équivalents s’affichent à une personne et n’exécutent rien : ils répondent `404 not_found`. Pour obtenir ce dialogue, lancez un [agent](/fr/docs/api/agents).
- **Les outils d’action n’attendent pas de confirmation.** Le chat en demande une. L’appel direct avec le scope `act` l’exécute aussitôt.
- **Les lectures en direct consomment des crédits.** Les outils du scope `explore` décomptent des crédits du plafond du mois du workspace.

## Catalogue

### Lire le corpus et le workspace

Outils de l’agent Piqline. Ils lisent ce que le workspace a déjà collecté : aucun crédit consommé, aucune écriture.

| Outil | Type | Scopes | Rôle |
| --- | --- | --- | --- |
| [`getCoverageStats`](/fr/docs/api/reference/corpus#getcoveragestats) | Lecture | `read` | Volumes et santé de la collecte : totaux, répartition par plateforme et par nature, série d’ingestion sur la fenêtre d’analyse (`1h`, `24h`, `7d` ou `30d`). |
| [`listSources`](/fr/docs/api/reference/corpus#listsources) | Lecture | `read` | Sources suivies par le workspace, avec le nombre d’items, l’état de santé et la dernière lecture. |
| [`searchItems`](/fr/docs/api/reference/corpus#searchitems) | Lecture | `read` | Recherche d’items (posts, vidéos, articles, annonces, offres) avec filtres : texte, plateforme, nature, source. Sans filtre, renvoie les plus récents (40 au plus). |
| [`getItem`](/fr/docs/api/reference/corpus#getitem) | Lecture | `read` | Détail d’un item : texte, transcription, OCR, thèmes détectés, items proches par le sens, et ses dates d’observation. |
| [`searchPassages`](/fr/docs/api/reference/corpus#searchpassages) | Lecture | `read` | Recherche par le sens dans les documents longs (PDF lus par le Motor) : passages les plus proches d’une question, avec l’item, la page et le titre de section. |
| [`citeItem`](/fr/docs/api/reference/corpus#citeitem) | Lecture | `read` | Vérifie qu’un passage est écrit mot pour mot dans un item et rend un numéro de citation ; sinon le passage le plus proche. Base du mode « Citations » du chat. |
| [`drawDiagram`](/fr/docs/api/reference/corpus#drawdiagram) | Lecture | `read` | Dessine la réponse en un schéma SVG (frise, matrice, flux, arbre…) : couleurs par rôle du thème, SVG nettoyé avant affichage. Base du mode « Diagramme » du chat. |
| [`createCanvas`](/fr/docs/api/reference/corpus#createcanvas) | Lecture | `read` | Compile un canvas (fichier TSX qui n’importe que le SDK piqline/canvas) et rend le code prêt à afficher, ou l’erreur à corriger. Base des modes Canvas et Rapport du chat. |
| [`getTopics`](/fr/docs/api/reference/corpus#gettopics) | Lecture | `read` | Thèmes détectés avec leur part de voix, et récits (le même sujet vu sur plusieurs sources). |
| [`getSignals`](/fr/docs/api/reference/corpus#getsignals) | Lecture | `read` | Signaux ouverts, déclenchés par les règles de persistance du workspace, avec leur avance et leur statut. |
| [`listWorkspaceTables`](/fr/docs/api/reference/corpus#listworkspacetables) | Lecture | `read` | Tables déjà créées dans le workspace : nom, commentaire, nombre de colonnes et de lignes, et si la table se remplit toute seule. |
| [`getWorkspaceTable`](/fr/docs/api/reference/corpus#getworkspacetable) | Lecture | `read` | Une table du workspace en JSON : schéma, colonnes et lignes. Sert de base ou de feed pour un site, une appli ou un agent (scope read). |
| [`listBookmarks`](/fr/docs/api/reference/corpus#listbookmarks) | Lecture | `read` | Signets et dossiers du coffre du workspace : titre, type, dossier, statut, admission. Filtre optionnel par mot, statut ou type. |
| [`listEntities`](/fr/docs/api/reference/corpus#listentities) | Lecture | `read` | Entités suivies (entreprises, marques, comptes publics) et items liés sur la période. |
| [`listWatchContracts`](/fr/docs/api/reference/corpus#listwatchcontracts) | Lecture | `read` | Contrats de veille posés sur les sources : intention, termes gardés et exclus, événement. |
| [`checkInvestigation`](/fr/docs/api/reference/corpus#checkinvestigation) | Lecture | `read` | État de la dernière enquête Edge, ou d’une enquête donnée : en attente, en cours, terminée avec ses candidats, ou en échec. |
| [`checkHunt`](/fr/docs/api/reference/corpus#checkhunt) | Lecture | `read` | État de la dernière chasse, ou d’une chasse donnée : étape, personnes trouvées avec le verdict du code et le vôtre, et pour chaque critère son statut et ses preuves publiques datées (adresse, date, extrait). Jamais une coordonnée. |
| [`planSourcePack`](/fr/docs/api/reference/corpus#plansourcepack) | Lecture | `read` | Propose un ensemble cohérent de sources à suivre pour un objectif. Ne crée rien. |
| [`listWidgets`](/fr/docs/api/reference/corpus#listwidgets) | Lecture | `read` | Widgets proposables pour un board de ce workspace, classés pour la personne, avec leurs raisons. |
| [`getAdvertiserCampaigns`](/fr/docs/api/reference/corpus#getadvertisercampaigns) | Lecture | `read` | Dossier publicitaire d’un annonceur des collectes du workspace : annonces, en diffusion, dates, bibliothèques, pays, besoins lus, nouvelles annonces par mois et montées en puissance, dernières annonces, signaux. Jamais une personne. Aucun crédit. |
| [`listAdSignals`](/fr/docs/api/reference/corpus#listadsignals) | Lecture | `read` | Signaux publicitaires du workspace, calculés chaque heure : campagne démarrée ou arrêtée, montée en puissance, nouveau pays, nouvelle plateforme, recrutement payé, promotion, lancement, nouvel annonceur. Aucun crédit. |
| [`listCollectedAds`](/fr/docs/api/reference/corpus#listcollectedads) | Lecture | `read` | Collectes publicitaires du workspace (Meta, TikTok, Google, LinkedIn), déjà lues : la liste, ou, avec le nom d’une collecte, ses répartitions (angles, offres, tons, formats), son rythme, ses annonces les plus longues et ses annonces filtrables par bibliothèque, statut, angle ou mot. Aucun crédit. |

### Explorer le web et les registres en direct

Lectures en direct sur le web et les réseaux publics. Elles consomment des crédits ; rien n’est stocké dans le workspace.

| Outil | Type | Scopes | Rôle |
| --- | --- | --- | --- |
| [`readPage`](/fr/docs/api/reference/direct#readpage) | Lecture en direct | `explore` | Lit une page web publique : titre, texte principal (6 000 caractères), flux découverts et 30 liens. |
| [`searchWeb`](/fr/docs/api/reference/direct#searchweb) | Lecture en direct | `explore` | Recherche sur le web public pour trouver des URL candidates. |
| [`browserRead`](/fr/docs/api/reference/direct#browserread) | Lecture en direct | `explore` | Lit une page dynamique ou protégée avec un navigateur forcé. Même forme que `readPage`. |
| [`waybackHistory`](/fr/docs/api/reference/direct#waybackhistory) | Lecture en direct | `explore` | Captures Wayback Machine d’une URL : première capture et captures récentes. |
| [`registryLookup`](/fr/docs/api/reference/direct#registrylookup) | Lecture en direct | `explore` | Recherche une entreprise dans un registre public : Sirene (France), EDGAR (États-Unis), Companies House (Royaume-Uni) ou OpenCorporates. |
| [`socialCatalog`](/fr/docs/api/reference/direct#socialcatalog) | Lecture en direct | `explore` | Liste les endpoints de lecture des réseaux sociaux (40 au plus), filtrables par plateforme. |
| [`socialCall`](/fr/docs/api/reference/direct#socialcall) | Lecture en direct | `explore` | Appelle un endpoint de lecture des réseaux sociaux et renvoie jusqu’à 20 items compacts. |
| [`previewSource`](/fr/docs/api/reference/direct#previewsource) | Lecture en direct | `explore` | Échantillon en direct (5 à 10 items) d’une source, avant de s’y abonner. |
| [`whoSaidItFirst`](/fr/docs/api/reference/direct#whosaiditfirst) | Lecture en direct | `explore` | Qui a publié une information en premier sur le web, page par page, et quand vos sources l’ont vue. Part d’un sujet ou d’un item ; gardée comme frise privée du workspace. |

### Facebook

Outils de l’agent Facebook : annonces Marketplace et groupes publics, lus en direct.

| Outil | Type | Scopes | Rôle |
| --- | --- | --- | --- |
| [`findMarketplaceLocation`](/fr/docs/api/reference/facebook#findmarketplacelocation) | Lecture en direct | `explore` | Convertit un nom de ville ou de zone en coordonnées Marketplace. |
| [`searchMarketplace`](/fr/docs/api/reference/facebook#searchmarketplace) | Lecture en direct | `explore` | Cherche des annonces Marketplace publiques par mot-clé autour d’un lieu (ville ou coordonnées), sur 3 pages au plus. |
| [`getMarketplaceListing`](/fr/docs/api/reference/facebook#getmarketplacelisting) | Lecture en direct | `explore` | Détail d’une annonce : description, attributs, photos, livraison, date exacte quand Facebook la donne. |
| [`getMarketplaceListings`](/fr/docs/api/reference/facebook#getmarketplacelistings) | Lecture en direct | `explore` | Détail de 2 à 6 annonces à la fois, sous forme de tableau comparatif. |
| [`getFacebookGroup`](/fr/docs/api/reference/facebook#getfacebookgroup) | Lecture en direct | `explore` | Fiche publique d’un groupe : confidentialité, taille, activité, catégories, règles. |
| [`getFacebookGroupPosts`](/fr/docs/api/reference/facebook#getfacebookgroupposts) | Lecture en direct | `explore` | Publications d’un groupe public, par pages de 3 (6 pages au plus). |
| [`getFacebookPost`](/fr/docs/api/reference/facebook#getfacebookpost) | Lecture en direct | `explore` | Détail d’une publication ou d’un reel public : texte, auteur, date, réactions, vues. |
| [`getFacebookPostComments`](/fr/docs/api/reference/facebook#getfacebookpostcomments) | Lecture en direct | `explore` | Commentaires d’une publication publique, filtrables par mots-clés (3 pages au plus). |

### LinkedIn

Outils de l’agent LinkedIn : posts, pages entreprise et publicités publics, lus en direct. Aucune coordonnée n’est jamais lue.

| Outil | Type | Scopes | Rôle |
| --- | --- | --- | --- |
| [`searchLinkedinPosts`](/fr/docs/api/reference/linkedin#searchlinkedinposts) | Lecture en direct | `explore` | Recherche de posts publics par mots-clés, en temps réel, du plus récent au plus ancien (une lecture partielle est signalée dans le résultat), avec le titre et le rôle de l’auteur quand le post recrute, et des signaux calculés par le code : recrutement, levée, lancement, expansion, réorganisation, disponibilité, départ. |
| [`probeLinkedinWatch`](/fr/docs/api/reference/linkedin#probelinkedinwatch) | Lecture en direct | `explore` | Sonde 1 à 3 variantes de requête avant de s’abonner à une veille LinkedIn, et renvoie le ticket d’enquête à joindre à l’abonnement. |
| [`getLinkedinPost`](/fr/docs/api/reference/linkedin#getlinkedinpost) | Lecture en direct | `explore` | Lit un post ou un article public : texte, auteur, date, réactions, commentaires avec leurs signaux. |
| [`getLinkedinPostTranscript`](/fr/docs/api/reference/linkedin#getlinkedinposttranscript) | Lecture en direct | `explore` | Transcription de la vidéo d’un post public, facturée seulement si elle existe. |
| [`getLinkedinCompany`](/fr/docs/api/reference/linkedin#getlinkedincompany) | Lecture en direct | `explore` | Page entreprise publique : description, effectif, secteur, financement, derniers posts avec leurs signaux. |
| [`getLinkedinCompanyPosts`](/fr/docs/api/reference/linkedin#getlinkedincompanyposts) | Lecture en direct | `explore` | Posts plus anciens d’une page entreprise, avec un résumé des signaux (recrutement, financement, lancements). |
| [`searchLinkedinAds`](/fr/docs/api/reference/linkedin#searchlinkedinads) | Lecture en direct | `explore` | Recherche dans la bibliothèque publicitaire : annonceur, format, dates, impressions. |
| [`getLinkedinAd`](/fr/docs/api/reference/linkedin#getlinkedinad) | Lecture en direct | `explore` | Détail d’une publicité de la bibliothèque : ciblage, impressions par pays, durée. |
| [`matchLinkedinPosts`](/fr/docs/api/reference/linkedin#matchlinkedinposts) | Lecture en direct | `explore` | Rapproche des personnes disponibles et des opportunités à partir de posts publics (deux recherches). |
| [`getLinkedinProfile`](/fr/docs/api/reference/linkedin#getlinkedinprofile) | Lecture en direct | `explore` | Lecture bornée d’un profil `/in/` public, uniquement à partir d’un post public qui désigne la personne. Réservé aux workspaces qui ont activé cette option. |

### Upwork

Outils de l’agent Upwork : offres publiques lues, notées et rédigées depuis la base de connaissances du workspace. Rien n’est envoyé à Upwork.

| Outil | Type | Scopes | Rôle |
| --- | --- | --- | --- |
| [`searchUpworkJobs`](/fr/docs/api/reference/upwork#searchupworkjobs) | Lecture en direct | `explore` | Lit une page de résultats publics (une dizaine d’offres) et note chaque offre selon la base de connaissances. Les offres sont ajoutées au pipeline du workspace. |
| [`getUpworkJob`](/fr/docs/api/reference/upwork#getupworkjob) | Lecture en direct | `explore` | Lit une offre : description, compétences, budget, activité, client. Ajoute un instantané daté au pipeline. |
| [`scoreUpworkJobs`](/fr/docs/api/reference/upwork#scoreupworkjobs) | Écriture | `write` | Note à nouveau les offres du pipeline après un changement de la base de connaissances. Aucune page n’est lue. |
| [`getUpworkRadar`](/fr/docs/api/reference/upwork#getupworkradar) | Lecture en direct | `explore` | Radar de marché : volume par jour, quartiles de tarif et de budget, compétences, concurrence, pays des clients. |
| [`listUpworkLeads`](/fr/docs/api/reference/upwork#listupworkleads) | Lecture | `read` | Pipeline Upwork : compte par statut, meilleures offres d’abord, issue de chacune. |
| [`updateUpworkLead`](/fr/docs/api/reference/upwork#updateupworklead) | Écriture | `write` | Change le statut d’une offre du pipeline (envoyée, réponse, entretien, gagnée, perdue, ignorée) et garde une note. |
| [`getUpworkKnowledge`](/fr/docs/api/reference/upwork#getupworkknowledge) | Lecture | `read` | Base de connaissances Upwork du workspace : services, outils, projets à éviter, tarifs plancher, études de cas, ton, signature. |
| [`updateUpworkKnowledge`](/fr/docs/api/reference/upwork#updateupworkknowledge) | Écriture | `write` | Met à jour la base de connaissances. Les listes envoyées remplacent les listes stockées. |
| [`listUpworkTemplates`](/fr/docs/api/reference/upwork#listupworktemplates) | Lecture | `read` | Modèles de proposition enregistrés, avec leurs emplacements et leurs règles de questions. |
| [`upsertUpworkTemplate`](/fr/docs/api/reference/upwork#upsertupworktemplate) | Écriture | `write` | Crée ou met à jour un modèle de proposition. |
| [`draftUpworkProposal`](/fr/docs/api/reference/upwork#draftupworkproposal) | Écriture | `write`, `explore` | Rédige une proposition pour une offre à partir d’un modèle. Le texte reste à coller soi-même sur Upwork. |
| [`listUpworkCampaigns`](/fr/docs/api/reference/upwork#listupworkcampaigns) | Lecture | `read` | Campagnes enregistrées : recherche, score minimum, statut, dernière actualisation, santé de la source. |
| [`saveUpworkCampaign`](/fr/docs/api/reference/upwork#saveupworkcampaign) | Écriture | `write` | Crée ou met à jour une campagne : nom, recherche, score minimum, modèle. |
| [`simulateUpworkCampaign`](/fr/docs/api/reference/upwork#simulateupworkcampaign) | Lecture en direct | `explore` | Simule une campagne sur de vraies offres avant de la suivre. Rien n’est enregistré. |
| [`followUpworkCampaign`](/fr/docs/api/reference/upwork#followupworkcampaign) | Action | `act` | Demande au Motor de suivre une campagne enregistrée, à son rythme de collecte. |
| [`pauseUpworkCampaign`](/fr/docs/api/reference/upwork#pauseupworkcampaign) | Action | `act` | Arrête le suivi d’une campagne par le Motor. Les offres déjà vues restent dans le pipeline. |
| [`refreshUpworkCampaigns`](/fr/docs/api/reference/upwork#refreshupworkcampaigns) | Écriture | `write`, `explore` | Actualise les campagnes suivies : fusionne les offres collectées par le Motor, relit la première page en direct, note les nouvelles offres. |
| [`checkUpworkOutcomes`](/fr/docs/api/reference/upwork#checkupworkoutcomes) | Écriture | `write`, `explore` | Relit les pages des candidatures en cours pour dater leur issue : clôturée, entretiens commencés, sans réponse. |
| [`syncUpworkReplies`](/fr/docs/api/reference/upwork#syncupworkreplies) | Écriture | `write` | Lit les e-mails de notification Upwork des boîtes connectées du créateur de la clé et fait avancer le statut des offres du pipeline. |

### Écrire dans le workspace

Outils de l’agent Piqline qui créent ou modifient des objets du workspace. Ils demandent le scope `write`.

| Outil | Type | Scopes | Rôle |
| --- | --- | --- | --- |
| [`updateWorkspaceProfile`](/fr/docs/api/reference/write#updateworkspaceprofile) | Écriture | `write` | Enregistre le profil de besoin du workspace : objectifs, sujets, entités, langues, zones, niveau, rythme. |
| [`followEntity`](/fr/docs/api/reference/write#followentity) | Écriture | `write` | Suit une entreprise, une marque ou un compte public (jamais une personne privée) pour lier ses items et ses mentions. |
| [`unfollowEntity`](/fr/docs/api/reference/write#unfollowentity) | Suppression | `write` | Arrête de suivre une entité. Ses liens existants restent. |
| [`saveBookmark`](/fr/docs/api/reference/write#savebookmark) | Écriture | `write` | Enregistre un signet dans le coffre du workspace. Une URL http(s) est mise en file pour lecture, persistance et vectorisation. |
| [`setWatchContract`](/fr/docs/api/reference/write#setwatchcontract) | Écriture | `write` | Pose un contrat de veille sur une source : la page de veille n’affiche plus que les items qui correspondent. Déterministe, sans modèle. |
| [`removeWatchContract`](/fr/docs/api/reference/write#removewatchcontract) | Suppression | `write` | Retire le contrat de veille d’une source : tous les items réapparaissent. |
| [`initReaderInterview`](/fr/docs/api/reference/write#initreaderinterview) | Écriture | `write` | Enregistre les deux réponses de l’entretien de lecture (essentiel ou détail, intention principale) sur le profil de lecture. |
| [`applyBoardChange`](/fr/docs/api/reference/write#applyboardchange) | Écriture | `write` | Applique à un board des modifications déjà validées. |
| [`buildDashboard`](/fr/docs/api/reference/write#builddashboard) | Écriture | `write` | Assemble un board directement, sans passer par le panneau de choix de widgets. |
| [`saveWorkspaceTable`](/fr/docs/api/reference/write#saveworkspacetable) | Écriture | `write` | Crée une table du workspace, remplie des colonnes utiles. |
| [`writeFromWatch`](/fr/docs/api/reference/write#writefromwatch) | Écriture | `write` | Écrit un texte à partir des items des veilles du workspace (article, post LinkedIn, thread X, légende Instagram, newsletter, script vidéo, communiqué, article SEO, e-mail, synthèse), en neuf langues, chaque fait cité [n] vers sa source ; le texte rejoint les brouillons. Consomme quelques crédits. |
| [`setTableFeed`](/fr/docs/api/reference/write#settablefeed) | Action | `act`, `write` | Fait vivre une table : dès qu’un item du corpus correspond à la règle, il s’ajoute, après confirmation. status=paused arrête le remplissage. |

### Agir sur les sources et les règles

Outils d’action de l’agent Piqline. Dans le chat, chacun demande une confirmation. Par l’API, l’appel direct avec le scope `act` vaut confirmation : n’appelez ces outils qu’après l’accord de la personne concernée.

| Outil | Type | Scopes | Rôle |
| --- | --- | --- | --- |
| [`subscribeSource`](/fr/docs/api/reference/act#subscribesource) | Action | `act` | S’abonne à une nouvelle source. Lance une vraie collecte (jobs de lecture, quotas des plateformes). |
| [`subscribeSources`](/fr/docs/api/reference/act#subscribesources) | Action | `act` | S’abonne à plusieurs sources en un appel et renvoie un résultat par source. |
| [`unsubscribeSource`](/fr/docs/api/reference/act#unsubscribesource) | Action | `act` | Arrête le suivi d’une source. Les items déjà collectés restent dans le corpus. |
| [`setHomeDashboard`](/fr/docs/api/reference/act#sethomedashboard) | Action | `act` | Définit un board enregistré comme accueil du workspace. |
| [`upsertSignalRule`](/fr/docs/api/reference/act#upsertsignalrule) | Action | `act` | Crée ou met à jour une règle de signal de persistance : elle se déclenche quand un item reste en ligne plus longtemps que le seuil. |
| [`upsertQuestionRule`](/fr/docs/api/reference/act#upsertquestionrule) | Action | `act` | Crée ou met à jour une question permanente : une phrase en langage courant que Jev pose sur chaque nouvel item des sources du workspace. Le seuil de probabilité fait le signal. |
| [`startInvestigation`](/fr/docs/api/reference/act#startinvestigation) | Action | `act` | Met en file une enquête Edge en arrière-plan pour ce workspace (owner ou admin). |
| [`startHunt`](/fr/docs/api/reference/act#starthunt) | Action | `act` | Lance une chasse : trouver des personnes qui remplissent des critères vérifiables, chaque critère prouvé par une source publique datée. Critères sensibles refusés, aucune coordonnée rendue. Tourne en arrière-plan et consomme des crédits du mois ; owner ou admin. |
| [`buildAdAudit`](/fr/docs/api/reference/act#buildadaudit) | Écriture | `write` | Audit rétroactif des campagnes de 1 à 6 annonceurs déjà collectés, sur N mois : une table du workspace (annonceur, mois, nouvelles annonces, arrêts, bibliothèques, pays, besoins lus, montée en puissance) et les chiffres d’un résumé cité. Aucun crédit. |
| [`findCreatorSponsors`](/fr/docs/api/reference/act#findcreatorsponsors) | Action | `act`, `write`, `explore` | Qui paie des créateurs YouTube dans une niche : recherche de vidéos récentes, sponsors inférés de chaque vidéo, table « Sponsors · niche » du workspace. Consomme des crédits ; confirmation dans le chat, owner ou admin. |
| [`importAdHistory`](/fr/docs/api/reference/act#importadhistory) | Action | `act`, `write`, `explore` | Importe l’historique Google d’une collecte annonceur : jusqu’à 20 pages (environ 800 annonces depuis 2021) pour dater les campagnes passées. Consomme des crédits ; confirmation dans le chat, owner ou admin. |
| [`startAdCollection`](/fr/docs/api/reference/act#startadcollection) | Action | `act`, `write`, `explore` | Lance une collecte publicitaire sur un annonceur (nom ou domaine) ou un mot-clé : lit Meta, TikTok, Google et LinkedIn, met chaque annonce au même format, puis lit l’angle, l’offre, l’audience et le ton. Consomme des crédits ; confirmation dans le chat, owner ou admin. |
