본문으로 건너뛰기

도구 레퍼런스

Upwork

Upwork. 도구 19개와 매개변수, 호출 예제.

Upwork 에이전트의 도구입니다. 공개 일감을 읽고, 점수를 매기고, 워크스페이스 지식 베이스를 바탕으로 답안을 작성합니다. Upwork로는 아무것도 전송되지 않습니다.

각 호출은 Authorization: Bearer에 키를 넣은 POST 요청입니다. JSON 본문이 도구의 입력이며, 응답은 { "tool": "nom", "output": … } 형태입니다. 예제에는 필수 매개변수만 포함되어 있습니다. 매개변수 설명은 에이전트가 읽는 설명과 같습니다.

searchUpworkJobs#

공개 결과 한 페이지(일감 약 10건)를 읽고 각 일감을 지식 베이스와 비교해 점수를 매깁니다. 일감은 워크스페이스 파이프라인에 추가됩니다.

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

유형: 실시간 읽기. 스코프: 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

유형: 실시간 읽기. 스코프: 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

유형: 쓰기. 스코프: 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

유형: 실시간 읽기. 스코프: 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

유형: 읽기. 스코프: 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

유형: 쓰기. 스코프: 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

유형: 읽기. 스코프: 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

유형: 쓰기. 스코프: 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

유형: 읽기. 스코프: 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

유형: 쓰기. 스코프: 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

유형: 쓰기. 스코프: 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

유형: 읽기. 스코프: 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

유형: 쓰기. 스코프: 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

유형: 실시간 읽기. 스코프: 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

유형: 실행. 스코프: 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

유형: 실행. 스코프: 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

유형: 쓰기. 스코프: 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

유형: 쓰기. 스코프: 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

유형: 쓰기. 스코프: 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에 대한 질문이 있거나 이 페이지에 오류가 있나요? 문의하기.