跳到正文

工具参考

Upwork

Upwork。19 个工具,附参数和调用示例。

Upwork 智能体的工具:读取公开职位,并依据工作区知识库对其评分和答复。不会向 Upwork 发送任何内容。

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

searchUpworkJobs#

读取一页公开结果(约十个职位),并对照知识库为每个职位评分。这些职位会加入工作区的管道。

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

类型:实时读取。Scope:explore。

参数类型必填说明
qstring是Keywords as a client would write them in a job post, e.g. 'next.js developer'
jobTypeany | hourly | fixed否
hourlyMininteger否Hourly rate floor in USD
hourlyMaxinteger否
fixedMininteger否Fixed-price budget floor in USD
fixedMaxinteger否
experiencearray<entry | intermediate | expert>否
proposalsarray<0-4 | 5-9 | 10-14 | 15-19 | 20-49>否Keep only jobs with this many proposals so far (less competition)
clientHiresarray<0 | 1-9 | 10+>否
pageinteger否
scoreboolean否Score each job against the knowledge base (judge capped at 12 per call)
persistboolean否Add the jobs to the workspace pipeline (upwork_pipeline)
curl -s https://piqline.com/api/v1/tools/searchUpworkJobs \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"levée de fonds"}'

getUpworkJob#

读取一个职位:描述、技能、预算、活跃度、客户。向管道中添加一份带日期的快照。

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

类型:实时读取。Scope:explore。

参数类型必填说明
urlstring是
scoreboolean否
curl -s https://piqline.com/api/v1/tools/getUpworkJob \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://exemple.fr/article"}'

scoreUpworkJobs#

知识库更改后,重新为管道中的职位评分。不读取任何页面。

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

类型:写入。Scope:write。

参数类型必填说明
jobIdsarray<string>是
curl -s https://piqline.com/api/v1/tools/scoreUpworkJobs \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jobIds":["texte"]}'

getUpworkRadar#

市场雷达:每日数量、费率和预算四分位数、技能、竞争情况、客户所在国家。

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

类型:实时读取。Scope:explore。

参数类型必填说明
searchobject否
curl -s https://piqline.com/api/v1/tools/getUpworkRadar \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

listUpworkLeads#

Upwork 管道:各状态的数量、最佳职位在前、每个职位的结果。

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

类型:读取。Scope:read。

参数类型必填说明
statusarray<new | shortlisted | drafted | submitted | viewed | replied | interview | won | …>否
minScoreinteger否
limitinteger否
curl -s https://piqline.com/api/v1/tools/listUpworkLeads \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

updateUpworkLead#

更改管道中某个职位的状态(已发送、已回复、面试、赢得、丢失、已忽略),并保留一条备注。

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

类型:写入。Scope:write。

参数类型必填说明
jobIdstring是
statusnew | shortlisted | drafted | submitted | viewed | replied | interview | won | …是
notestring否
curl -s https://piqline.com/api/v1/tools/updateUpworkLead \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jobId":"5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70","status":"new"}'

getUpworkKnowledge#

工作区的 Upwork 知识库:服务、工具、应避开的项目、最低费率、案例、语气、签名。

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

类型:读取。Scope:read。

该工具没有参数:发送空请求体 {}。

curl -s https://piqline.com/api/v1/tools/getUpworkKnowledge \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

updateUpworkKnowledge#

更新知识库。你发送的列表会替换已保存的列表。

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

类型:写入。Scope:write。

参数类型必填说明
namestring否
headlinestring否
servicesarray<string>否
toolsarray<string>否
avoidarray<string>否Kinds of projects to never bid on, as short phrases or keywords
languagesarray<string>否
hourlyMinnumber否Lowest acceptable hourly rate, USD
fixedMinnumber否Lowest acceptable fixed budget, USD
freelancerCountrystring否
caseStudiesarray<object>否
examplesarray<object>否
tonestring否
signaturestring否
curl -s https://piqline.com/api/v1/tools/updateUpworkKnowledge \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

listUpworkTemplates#

已保存的提案模板,包含其占位符和提问规则。

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

类型:读取。Scope:read。

该工具没有参数:发送空请求体 {}。

curl -s https://piqline.com/api/v1/tools/listUpworkTemplates \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

upsertUpworkTemplate#

创建或更新提案模板。

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

类型:写入。Scope:write。

参数类型必填说明
idstring是Stable slug; reuse it to update
namestring是
bodystring是Literal text kept word for word. { {instruction} } = filled per job by the writer. { {var:job.title} } etc. = filled by code.
questionRulesarray<object>否
curl -s https://piqline.com/api/v1/tools/upsertUpworkTemplate \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70","name":"texte","body":"texte"}'

draftUpworkProposal#

依据模板为某个职位起草提案。文本需要你自己粘贴到 Upwork。

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

类型:写入。Scope:write, explore。

参数类型必填说明
urlstring否Upwork job URL
jobIdstring否Job id already in the pipeline, e.g. ~022113077029286601014
templateIdstring否Template id or name; default = first saved template, else the built-in one
screeningQuestionsarray<string>否Screening questions copied verbatim from the job
extraInstructionsstring否
curl -s https://piqline.com/api/v1/tools/draftUpworkProposal \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

listUpworkCampaigns#

已保存的活动:搜索、最低分数、状态、最近刷新、来源健康状况。

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

类型:读取。Scope:read。

该工具没有参数:发送空请求体 {}。

curl -s https://piqline.com/api/v1/tools/listUpworkCampaigns \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

saveUpworkCampaign#

创建或更新活动:名称、搜索、最低分数、模板。

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

类型:写入。Scope:write。

参数类型必填说明
idstring否Stable slug; reuse it to update an existing campaign
namestring是
searchobject是
minScoreinteger否
templateIdstring否
curl -s https://piqline.com/api/v1/tools/saveUpworkCampaign \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"texte","search":{"q":"levée de fonds"}}'

simulateUpworkCampaign#

在关注活动之前,用真实职位模拟它。不保存任何内容。

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

类型:实时读取。Scope:explore。

参数类型必填说明
campaignIdstring否
campaignobject否
pagesinteger否
curl -s https://piqline.com/api/v1/tools/simulateUpworkCampaign \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

followUpworkCampaign#

请求 Motor 按其采集节奏关注一个已保存的活动。

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

类型:操作。Scope:act。

参数类型必填说明
campaignIdstring是
namestring否Nom de la campagne, pour la carte de confirmation.
curl -s https://piqline.com/api/v1/tools/followUpworkCampaign \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"campaignId":"5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70"}'

pauseUpworkCampaign#

让 Motor 停止关注某个活动。已看到的职位保留在管道中。

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

类型:操作。Scope:act。

参数类型必填说明
campaignIdstring是
namestring否Nom de la campagne, pour la carte de confirmation.
curl -s https://piqline.com/api/v1/tools/pauseUpworkCampaign \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"campaignId":"5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70"}'

refreshUpworkCampaigns#

刷新被关注的活动:合并 Motor 采集的职位,重新实时读取第一页,并为新职位评分。

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

类型:写入。Scope:write, explore。

参数类型必填说明
campaignIdstring否
liveboolean否
curl -s https://piqline.com/api/v1/tools/refreshUpworkCampaigns \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

checkUpworkOutcomes#

重新读取进行中申请的页面,标注结果日期:已关闭、已开始面试、无回复。

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

类型:写入。Scope:write, explore。

参数类型必填说明
jobIdsarray<string>否
limitinteger否
curl -s https://piqline.com/api/v1/tools/checkUpworkOutcomes \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

syncUpworkReplies#

读取密钥创建者已连接邮箱中的 Upwork 通知邮件,并推进管道中职位的状态。

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

类型:写入。Scope:write。

参数类型必填说明
accountIdstring否
limitinteger否
curl -s https://piqline.com/api/v1/tools/syncUpworkReplies \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

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