Outils

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. 84 outils sont appelables ; le catalogue les liste avec leurs scopes, et la référence décrit les paramètres de chacun, avec des exemples d’appel.

Lister les outils#

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, facebook, linkedin, upwork ou onboarding. Chaque outil de la liste porte :

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#

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.

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

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();

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 :

{
  "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.

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.
• 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 coûtent. Les outils du scope explore consomment des crédits fournisseurs (Firecrawl, Scrape Creators…) : la description de l’outil indique le coût quand il existe.

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 fournisseur, aucune écriture.

Explorer le web et les registres en direct#

Lectures en direct sur des sites et des fournisseurs tiers. Elles consomment des crédits fournisseurs ; rien n’est stocké dans le workspace.

Facebook#

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

LinkedIn#

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

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.

Écrire dans le workspace#

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

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.