跳到正文

工具参考

操作

对来源和规则执行操作。12 个工具,附参数和调用示例。

Piqline 智能体的操作工具。在聊天中,每个工具都会请求确认。通过 API 时,带有 act scope 的直接调用即视为确认:只有在相关人员同意之后,才调用这些工具。

每次调用都是一个 POST 请求,密钥放在 Authorization: Bearer 中。JSON 请求体是工具的输入,响应形如 { "tool": "nom", "output": … }。示例中只包含必填参数。参数说明与智能体读到的相同。

subscribeSource#

订阅一个新来源。会启动真正的采集(读取任务、平台配额)。

POSThttps://piqline.com/api/v1/tools/subscribeSource

类型:操作。Scope:act。

参数类型必填说明
platforminstagram | tiktok | youtube | twitter | x | threads | linkedin | reddit | …是
targetstring否Handle, URL, mot-clé Marketplace, ou communauté. Une recherche LinkedIn peut s’appuyer sur query.
titlestring否
facebookKindpage | group | marketplace否Facebook : page publique, groupe public, ou recherche Marketplace.
tiktokKindprofile | live否TikTok only. live = /v1/tiktok/user/live probe, not profile posts.
linkedinKindcompany | search否LinkedIn only. search = recurring public-post search on query.
locationstring否Marketplace : ville ou zone.
latnumber否
lngnumber否
radiusKmnumber否
minPricenumber否
maxPricenumber否
sortBystring否
conditionstring否
dateListedstring否
categoryIdstring否
deliverystring否
availabilitystring否
datePostedlast-hour | last-day | last-week | last-month | last-year否LinkedIn search only. Window of each run, default last-week.
querystring否Marketplace keyword or LinkedIn search query.
intentstring否LinkedIn search: the user's ask, kept on the source.
detectionEventhiring | funding | launch | expansion | reorg | open_to_work | leaving | interested_comment | …否
detectionRoundsarray<pre_seed | seed | series_a | series_b | series_c | series_d | bridge | extension | …>否
detectionSectorsarray<string>否
detectionGeosarray<string>否
detectionVocabularyarray<string>否
moreQueriesarray<string>否LinkedIn search only. Up to 3 other phrases followed together with query, one per job family, each probed by probeLinkedinWatch with at least one relevant post.
maxPostsinteger否LinkedIn search only. Posts read at most per run: 15, 50, 100 or 200 (default 50). Each post read uses credits; a run reads only posts newer than the last one stored.
detectionAuthorsarray<recruiter | founder | manager>否LinkedIn search only. Keep only posts whose author's title reads as one of these roles (recruiter, founder, manager). Empty = every author.
rhythmhourly | every_6h | daily | weekly否LinkedIn search only. Run rhythm chosen by the user (hourly, every_6h, daily, weekly). Omit to keep the rhythm suggested by the probe.
investigationobject否Lot 7: pass the investigation object from probeLinkedinWatch unchanged.
trackItemVariationsboolean否Marketplace / listing only. True only if the user explicitly asked to follow price, text or presence on the same item (T8). Default false: new items only.
enrichFromUrlboolean否Listing / web only. Open each item URL to read the page text. Default false. Each opened page uses credits. Set true only if the user explicitly asked.
curl -s https://piqline.com/api/v1/tools/subscribeSource \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"instagram"}'

subscribeSources#

一次调用订阅多个来源,并为每个来源返回一个结果。

POSThttps://piqline.com/api/v1/tools/subscribeSources

类型:操作。Scope:act。

参数类型必填说明
sourcesarray<object>是
curl -s https://piqline.com/api/v1/tools/subscribeSources \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sources":[{"platform":"instagram"}]}'

unsubscribeSource#

停止关注某个来源。已采集的条目保留在语料库中。

POSThttps://piqline.com/api/v1/tools/unsubscribeSource

类型:操作。Scope:act。

参数类型必填说明
sourceIdstring是
labelstring否Nom lisible de la source (celui de listSources). Obligatoire pour la carte de confirmation.
curl -s https://piqline.com/api/v1/tools/unsubscribeSource \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sourceId":"5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70"}'

setHomeDashboard#

把一个已保存的看板设为工作区首页。

POSThttps://piqline.com/api/v1/tools/setHomeDashboard

类型:操作。Scope:act。

参数类型必填说明
dashboardIdstring是
titlestring否Titre du tableau, pour la carte de confirmation. Jamais l’identifiant seul.
curl -s https://piqline.com/api/v1/tools/setHomeDashboard \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dashboardId":"5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70"}'

upsertSignalRule#

创建或更新持续性信号规则:当条目在线时间超过阈值时触发。

POSThttps://piqline.com/api/v1/tools/upsertSignalRule

类型:操作。Scope:act。

参数类型必填说明
ruleIdstring否
thresholdDaysinteger否
staleGraceDaysinteger否
itemTypesarray<post | video | article | listing | job_offer>否
enabledboolean否
curl -s https://piqline.com/api/v1/tools/upsertSignalRule \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

upsertQuestionRule#

创建或更新常设问题:一句用日常语言写的话,Jev 会对工作区来源中的每个新条目提出这个问题。概率阈值决定信号。

POSThttps://piqline.com/api/v1/tools/upsertQuestionRule

类型:操作。Scope:act。

参数类型必填说明
ruleIdstring否
questionstring是
minProbabilitynumber否
itemTypesarray<post | video | article | listing | job_offer>否
enabledboolean否
curl -s https://piqline.com/api/v1/tools/upsertQuestionRule \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"question":"texte"}'

startInvestigation#

为此工作区把一项后台 Edge 调查加入队列(所有者或管理员)。

POSThttps://piqline.com/api/v1/tools/startInvestigation

类型:操作。Scope:act。

参数类型必填说明
intentstring是Need in one sentence, from sujets / zones / langues already noted
perimeterobject否Optional sectors, geos, accounts, seed URLs from the need profile
curl -s https://piqline.com/api/v1/tools/startInvestigation \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"intent":"texte"}'

startHunt#

启动搜寻:查找满足可验证标准的人员,每项标准都有带日期的公开来源作证。敏感标准会被拒绝,也不会返回联系方式。在后台运行,并消耗当月积分;所有者或管理员。

POSThttps://piqline.com/api/v1/tools/startHunt

类型:操作。Scope:act。

参数类型必填说明
briefstring是Who to find, in one or two sentences.
purposestring是Why these people are sought, in one sentence. Recorded with the hunt.
criteriaarray<object>是
targetinteger否How many people to find.
curl -s https://piqline.com/api/v1/tools/startHunt \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"brief":"texte","purpose":"texte","criteria":[{"label":"texte"}]}'

buildAdAudit#

对已采集的 1 到 6 个广告主的投放活动做追溯审计,覆盖 N 个月:生成一张工作区表格(广告主、月份、新增广告、停投、广告库、国家、已读取的需求、放量)以及带引用的摘要所用的数字。不消耗积分。

POSThttps://piqline.com/api/v1/tools/buildAdAudit

类型:写入。Scope:write。

参数类型必填说明
advertisersarray<string>是Names of the advertisers, as in the collections.
monthsinteger否
namestring否Table name. Default: « Audit publicitaire ».
curl -s https://piqline.com/api/v1/tools/buildAdAudit \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"advertisers":["texte"]}'

findCreatorSponsors#

谁在某个细分领域赞助 YouTube 创作者:搜索近期视频,从每个视频推断赞助商,生成“赞助商 · 领域”工作区表格。会消耗积分;在聊天中需确认,所有者或管理员。

POSThttps://piqline.com/api/v1/tools/findCreatorSponsors

类型:操作。Scope:act, write, explore。

参数类型必填说明
nichestring是Words of the niche, as a creator would title a video (« compléments alimentaires »).
videosinteger否
periodthis_week | this_month | this_year否
countrystring否YouTube region, FR by default.
followboolean否true: follow the niche, run again every week, and raise A13 when a brand starts sponsoring creators of the niche (in the bell and alert e-mails).
curl -s https://piqline.com/api/v1/tools/findCreatorSponsors \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"niche":"texte"}'

importAdHistory#

导入某个广告主采集的 Google 历史:最多 20 页(自 2021 年以来约 800 条广告),用于标注过往投放的日期。会消耗积分;在聊天中需确认,所有者或管理员。

POSThttps://piqline.com/api/v1/tools/importAdHistory

类型:操作。Scope:act, write, explore。

参数类型必填说明
collectionstring是Name of the advertiser collection.
curl -s https://piqline.com/api/v1/tools/importAdHistory \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"collection":"texte"}'

startAdCollection#

针对某个广告主(名称或域名)或关键词启动广告采集:读取 Meta、TikTok、Google 和 LinkedIn,把每条广告统一为相同格式,然后判读角度、优惠、受众和语气。会消耗积分;在聊天中需确认,所有者或管理员。

POSThttps://piqline.com/api/v1/tools/startAdCollection

类型:操作。Scope:act, write, explore。

参数类型必填说明
querystring是Nom ou domaine de l'annonceur (kind advertiser), ou mot-clé (kind keyword).
kindadvertiser | keyword否
librariesarray<meta | tiktok | google | linkedin>否Bibliothèques à lire. Google ne cherche pas par mot-clé.
countrystring否Code pays ISO. Restreint Meta et LinkedIn, choisit l'entité annonceur de Google (FR par défaut). Courants : FR, BE, CH, LU, DE, ES, IT, NL, GB, IE, US, CA, MA, SN, CI, AU, BR, JP.
depthapercu | large否apercu : une page par bibliothèque. large : jusqu'à quatre pages (plus long).
cadencemanuel | quotidien | hebdomadaire否manuel : à la main. quotidien ou hebdomadaire : la collecte se repasse seule, dans le plafond du jour, et ses signaux arrivent dans la cloche.
curl -s https://piqline.com/api/v1/tools/startAdCollection \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"levée de fonds"}'

对 API 有疑问,或发现本页有误? 联系我们.