工具参考
Upwork
Upwork。19 个工具,附参数和调用示例。
Upwork 智能体的工具:读取公开职位,并依据工作区知识库对其评分和答复。不会向 Upwork 发送任何内容。
每次调用都是一个 POST 请求,密钥放在 Authorization: Bearer 中。JSON 请求体是工具的输入,响应形如 { "tool": "nom", "output": … }。示例中只包含必填参数。参数说明与智能体读到的相同。
searchUpworkJobs#
读取一页公开结果(约十个职位),并对照知识库为每个职位评分。这些职位会加入工作区的管道。
POSThttps://piqline.com/api/v1/tools/searchUpworkJobs
类型:实时读取。Scope:explore。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
q | string | 是 | Keywords as a client would write them in a job post, e.g. 'next.js developer' |
jobType | any | hourly | fixed | 否 | |
hourlyMin | integer | 否 | Hourly rate floor in USD |
hourlyMax | integer | 否 | |
fixedMin | integer | 否 | Fixed-price budget floor in USD |
fixedMax | integer | 否 | |
experience | array<entry | intermediate | expert> | 否 | |
proposals | array<0-4 | 5-9 | 10-14 | 15-19 | 20-49> | 否 | Keep only jobs with this many proposals so far (less competition) |
clientHires | array<0 | 1-9 | 10+> | 否 | |
page | integer | 否 | |
score | boolean | 否 | Score each job against the knowledge base (judge capped at 12 per call) |
persist | boolean | 否 | 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"}'const response = await fetch("https://piqline.com/api/v1/tools/searchUpworkJobs", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"q": "levée de fonds"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/searchUpworkJobs",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"q": "levée de fonds",
},
)
output = response.json()["output"]getUpworkJob#
读取一个职位:描述、技能、预算、活跃度、客户。向管道中添加一份带日期的快照。
POSThttps://piqline.com/api/v1/tools/getUpworkJob
类型:实时读取。Scope:explore。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
url | string | 是 | |
score | boolean | 否 |
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"}'const response = await fetch("https://piqline.com/api/v1/tools/getUpworkJob", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"url": "https://exemple.fr/article"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/getUpworkJob",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"url": "https://exemple.fr/article",
},
)
output = response.json()["output"]scoreUpworkJobs#
知识库更改后,重新为管道中的职位评分。不读取任何页面。
POSThttps://piqline.com/api/v1/tools/scoreUpworkJobs
类型:写入。Scope:write。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
jobIds | array<string> | 是 |
curl -s https://piqline.com/api/v1/tools/scoreUpworkJobs \
-H "Authorization: Bearer $PIQLINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jobIds":["texte"]}'const response = await fetch("https://piqline.com/api/v1/tools/scoreUpworkJobs", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"jobIds": [
"texte"
]
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/scoreUpworkJobs",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"jobIds": [
"texte",
],
},
)
output = response.json()["output"]getUpworkRadar#
市场雷达:每日数量、费率和预算四分位数、技能、竞争情况、客户所在国家。
POSThttps://piqline.com/api/v1/tools/getUpworkRadar
类型:实时读取。Scope:explore。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
search | object | 否 |
curl -s https://piqline.com/api/v1/tools/getUpworkRadar \
-H "Authorization: Bearer $PIQLINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const response = await fetch("https://piqline.com/api/v1/tools/getUpworkRadar", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/getUpworkRadar",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={},
)
output = response.json()["output"]listUpworkLeads#
Upwork 管道:各状态的数量、最佳职位在前、每个职位的结果。
POSThttps://piqline.com/api/v1/tools/listUpworkLeads
类型:读取。Scope:read。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
status | array<new | shortlisted | drafted | submitted | viewed | replied | interview | won | …> | 否 | |
minScore | integer | 否 | |
limit | integer | 否 |
curl -s https://piqline.com/api/v1/tools/listUpworkLeads \
-H "Authorization: Bearer $PIQLINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const response = await fetch("https://piqline.com/api/v1/tools/listUpworkLeads", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/listUpworkLeads",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={},
)
output = response.json()["output"]updateUpworkLead#
更改管道中某个职位的状态(已发送、已回复、面试、赢得、丢失、已忽略),并保留一条备注。
POSThttps://piqline.com/api/v1/tools/updateUpworkLead
类型:写入。Scope:write。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
jobId | string | 是 | |
status | new | shortlisted | drafted | submitted | viewed | replied | interview | won | … | 是 | |
note | string | 否 |
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"}'const response = await fetch("https://piqline.com/api/v1/tools/updateUpworkLead", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"jobId": "5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70",
"status": "new"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/updateUpworkLead",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"jobId": "5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70",
"status": "new",
},
)
output = response.json()["output"]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 '{}'const response = await fetch("https://piqline.com/api/v1/tools/getUpworkKnowledge", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/getUpworkKnowledge",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={},
)
output = response.json()["output"]updateUpworkKnowledge#
更新知识库。你发送的列表会替换已保存的列表。
POSThttps://piqline.com/api/v1/tools/updateUpworkKnowledge
类型:写入。Scope:write。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
name | string | 否 | |
headline | string | 否 | |
services | array<string> | 否 | |
tools | array<string> | 否 | |
avoid | array<string> | 否 | Kinds of projects to never bid on, as short phrases or keywords |
languages | array<string> | 否 | |
hourlyMin | number | 否 | Lowest acceptable hourly rate, USD |
fixedMin | number | 否 | Lowest acceptable fixed budget, USD |
freelancerCountry | string | 否 | |
caseStudies | array<object> | 否 | |
examples | array<object> | 否 | |
tone | string | 否 | |
signature | string | 否 |
curl -s https://piqline.com/api/v1/tools/updateUpworkKnowledge \
-H "Authorization: Bearer $PIQLINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const response = await fetch("https://piqline.com/api/v1/tools/updateUpworkKnowledge", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/updateUpworkKnowledge",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={},
)
output = response.json()["output"]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 '{}'const response = await fetch("https://piqline.com/api/v1/tools/listUpworkTemplates", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/listUpworkTemplates",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={},
)
output = response.json()["output"]upsertUpworkTemplate#
创建或更新提案模板。
POSThttps://piqline.com/api/v1/tools/upsertUpworkTemplate
类型:写入。Scope:write。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | string | 是 | Stable slug; reuse it to update |
name | string | 是 | |
body | string | 是 | Literal text kept word for word. { {instruction} } = filled per job by the writer. { {var:job.title} } etc. = filled by code. |
questionRules | array<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"}'const response = await fetch("https://piqline.com/api/v1/tools/upsertUpworkTemplate", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"id": "5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70",
"name": "texte",
"body": "texte"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/upsertUpworkTemplate",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"id": "5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70",
"name": "texte",
"body": "texte",
},
)
output = response.json()["output"]draftUpworkProposal#
依据模板为某个职位起草提案。文本需要你自己粘贴到 Upwork。
POSThttps://piqline.com/api/v1/tools/draftUpworkProposal
类型:写入。Scope:write, explore。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
url | string | 否 | Upwork job URL |
jobId | string | 否 | Job id already in the pipeline, e.g. ~022113077029286601014 |
templateId | string | 否 | Template id or name; default = first saved template, else the built-in one |
screeningQuestions | array<string> | 否 | Screening questions copied verbatim from the job |
extraInstructions | string | 否 |
curl -s https://piqline.com/api/v1/tools/draftUpworkProposal \
-H "Authorization: Bearer $PIQLINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const response = await fetch("https://piqline.com/api/v1/tools/draftUpworkProposal", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/draftUpworkProposal",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={},
)
output = response.json()["output"]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 '{}'const response = await fetch("https://piqline.com/api/v1/tools/listUpworkCampaigns", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/listUpworkCampaigns",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={},
)
output = response.json()["output"]saveUpworkCampaign#
创建或更新活动:名称、搜索、最低分数、模板。
POSThttps://piqline.com/api/v1/tools/saveUpworkCampaign
类型:写入。Scope:write。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | string | 否 | Stable slug; reuse it to update an existing campaign |
name | string | 是 | |
search | object | 是 | |
minScore | integer | 否 | |
templateId | string | 否 |
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"}}'const response = await fetch("https://piqline.com/api/v1/tools/saveUpworkCampaign", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"name": "texte",
"search": {
"q": "levée de fonds"
}
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/saveUpworkCampaign",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"name": "texte",
"search": {
"q": "levée de fonds",
},
},
)
output = response.json()["output"]simulateUpworkCampaign#
在关注活动之前,用真实职位模拟它。不保存任何内容。
POSThttps://piqline.com/api/v1/tools/simulateUpworkCampaign
类型:实时读取。Scope:explore。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
campaignId | string | 否 | |
campaign | object | 否 | |
pages | integer | 否 |
curl -s https://piqline.com/api/v1/tools/simulateUpworkCampaign \
-H "Authorization: Bearer $PIQLINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const response = await fetch("https://piqline.com/api/v1/tools/simulateUpworkCampaign", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/simulateUpworkCampaign",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={},
)
output = response.json()["output"]followUpworkCampaign#
请求 Motor 按其采集节奏关注一个已保存的活动。
POSThttps://piqline.com/api/v1/tools/followUpworkCampaign
类型:操作。Scope:act。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
campaignId | string | 是 | |
name | string | 否 | 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"}'const response = await fetch("https://piqline.com/api/v1/tools/followUpworkCampaign", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"campaignId": "5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/followUpworkCampaign",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"campaignId": "5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70",
},
)
output = response.json()["output"]pauseUpworkCampaign#
让 Motor 停止关注某个活动。已看到的职位保留在管道中。
POSThttps://piqline.com/api/v1/tools/pauseUpworkCampaign
类型:操作。Scope:act。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
campaignId | string | 是 | |
name | string | 否 | 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"}'const response = await fetch("https://piqline.com/api/v1/tools/pauseUpworkCampaign", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"campaignId": "5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/pauseUpworkCampaign",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"campaignId": "5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70",
},
)
output = response.json()["output"]refreshUpworkCampaigns#
刷新被关注的活动:合并 Motor 采集的职位,重新实时读取第一页,并为新职位评分。
POSThttps://piqline.com/api/v1/tools/refreshUpworkCampaigns
类型:写入。Scope:write, explore。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
campaignId | string | 否 | |
live | boolean | 否 |
curl -s https://piqline.com/api/v1/tools/refreshUpworkCampaigns \
-H "Authorization: Bearer $PIQLINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const response = await fetch("https://piqline.com/api/v1/tools/refreshUpworkCampaigns", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/refreshUpworkCampaigns",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={},
)
output = response.json()["output"]checkUpworkOutcomes#
重新读取进行中申请的页面,标注结果日期:已关闭、已开始面试、无回复。
POSThttps://piqline.com/api/v1/tools/checkUpworkOutcomes
类型:写入。Scope:write, explore。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
jobIds | array<string> | 否 | |
limit | integer | 否 |
curl -s https://piqline.com/api/v1/tools/checkUpworkOutcomes \
-H "Authorization: Bearer $PIQLINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const response = await fetch("https://piqline.com/api/v1/tools/checkUpworkOutcomes", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/checkUpworkOutcomes",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={},
)
output = response.json()["output"]syncUpworkReplies#
读取密钥创建者已连接邮箱中的 Upwork 通知邮件,并推进管道中职位的状态。
POSThttps://piqline.com/api/v1/tools/syncUpworkReplies
类型:写入。Scope:write。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
accountId | string | 否 | |
limit | integer | 否 |
curl -s https://piqline.com/api/v1/tools/syncUpworkReplies \
-H "Authorization: Bearer $PIQLINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const response = await fetch("https://piqline.com/api/v1/tools/syncUpworkReplies", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/syncUpworkReplies",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={},
)
output = response.json()["output"]