Vai al contenuto

Riferimento dei tool

Upwork

Upwork. 19 tool, con i loro parametri ed esempi di chiamata.

Tool dell'agente Upwork: offerte pubbliche lette, valutate e riscontrate a partire dalla knowledge base del workspace. Nulla viene inviato a Upwork.

Ogni chiamata è una richiesta POST con la chiave in Authorization: Bearer. Il corpo JSON è l'input del tool, e la risposta ha la forma { "tool": "nom", "output": … }. Gli esempi contengono solo i parametri obbligatori. Le descrizioni dei parametri sono quelle che leggono gli agenti.

searchUpworkJobs#

Legge una pagina di risultati pubblici (una decina di offerte) e valuta ciascuna offerta rispetto alla knowledge base. Le offerte vengono aggiunte alla pipeline del workspace.

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

Tipo: Lettura in diretta. Scope: explore.

ParametroTipoObbligatorioDescrizione
qstringSìKeywords as a client would write them in a job post, e.g. 'next.js developer'
jobTypeany | hourly | fixedNo
hourlyMinintegerNoHourly rate floor in USD
hourlyMaxintegerNo
fixedMinintegerNoFixed-price budget floor in USD
fixedMaxintegerNo
experiencearray<entry | intermediate | expert>No
proposalsarray<0-4 | 5-9 | 10-14 | 15-19 | 20-49>NoKeep only jobs with this many proposals so far (less competition)
clientHiresarray<0 | 1-9 | 10+>No
pageintegerNo
scorebooleanNoScore each job against the knowledge base (judge capped at 12 per call)
persistbooleanNoAdd 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#

Legge un'offerta: descrizione, competenze, budget, attività, cliente. Aggiunge alla pipeline un'istantanea datata.

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

Tipo: Lettura in diretta. Scope: explore.

ParametroTipoObbligatorioDescrizione
urlstringSì
scorebooleanNo
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#

Rivaluta le offerte della pipeline dopo una modifica della knowledge base. Nessuna pagina viene letta.

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

Tipo: Scrittura. Scope: write.

ParametroTipoObbligatorioDescrizione
jobIdsarray<string>Sì
curl -s https://piqline.com/api/v1/tools/scoreUpworkJobs \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jobIds":["texte"]}'

getUpworkRadar#

Radar di mercato: volume al giorno, quartili di tariffa e di budget, competenze, concorrenza, paesi dei clienti.

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

Tipo: Lettura in diretta. Scope: explore.

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

listUpworkLeads#

Pipeline Upwork: conteggio per stato, prima le migliori offerte, esito di ciascuna.

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

Tipo: Lettura. Scope: read.

ParametroTipoObbligatorioDescrizione
statusarray<new | shortlisted | drafted | submitted | viewed | replied | interview | won | …>No
minScoreintegerNo
limitintegerNo
curl -s https://piqline.com/api/v1/tools/listUpworkLeads \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

updateUpworkLead#

Modifica lo stato di un'offerta della pipeline (inviata, risposta, colloquio, vinta, persa, ignorata) e conserva una nota.

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

Tipo: Scrittura. Scope: write.

ParametroTipoObbligatorioDescrizione
jobIdstringSì
statusnew | shortlisted | drafted | submitted | viewed | replied | interview | won | …Sì
notestringNo
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#

Knowledge base Upwork del workspace: servizi, strumenti, progetti da evitare, tariffe minime, casi di studio, tono, firma.

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

Tipo: Lettura. Scope: read.

Questo tool non ha parametri: invia un corpo vuoto, {}.

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

updateUpworkKnowledge#

Aggiorna la knowledge base. Gli elenchi che invii sostituiscono quelli memorizzati.

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

Tipo: Scrittura. Scope: write.

ParametroTipoObbligatorioDescrizione
namestringNo
headlinestringNo
servicesarray<string>No
toolsarray<string>No
avoidarray<string>NoKinds of projects to never bid on, as short phrases or keywords
languagesarray<string>No
hourlyMinnumberNoLowest acceptable hourly rate, USD
fixedMinnumberNoLowest acceptable fixed budget, USD
freelancerCountrystringNo
caseStudiesarray<object>No
examplesarray<object>No
tonestringNo
signaturestringNo
curl -s https://piqline.com/api/v1/tools/updateUpworkKnowledge \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

listUpworkTemplates#

Modelli di proposta salvati, con i loro slot e le loro regole per le domande.

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

Tipo: Lettura. Scope: read.

Questo tool non ha parametri: invia un corpo vuoto, {}.

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

upsertUpworkTemplate#

Crea o aggiorna un modello di proposta.

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

Tipo: Scrittura. Scope: write.

ParametroTipoObbligatorioDescrizione
idstringSìStable slug; reuse it to update
namestringSì
bodystringSìLiteral text kept word for word. { {instruction} } = filled per job by the writer. { {var:job.title} } etc. = filled by code.
questionRulesarray<object>No
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#

Redige una bozza di proposta per un'offerta a partire da un modello. Incolli tu stesso il testo su Upwork.

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

Tipo: Scrittura. Scope: write, explore.

ParametroTipoObbligatorioDescrizione
urlstringNoUpwork job URL
jobIdstringNoJob id already in the pipeline, e.g. ~022113077029286601014
templateIdstringNoTemplate id or name; default = first saved template, else the built-in one
screeningQuestionsarray<string>NoScreening questions copied verbatim from the job
extraInstructionsstringNo
curl -s https://piqline.com/api/v1/tools/draftUpworkProposal \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

listUpworkCampaigns#

Campagne salvate: ricerca, punteggio minimo, stato, ultimo aggiornamento, stato delle fonti.

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

Tipo: Lettura. Scope: read.

Questo tool non ha parametri: invia un corpo vuoto, {}.

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

saveUpworkCampaign#

Crea o aggiorna una campagna: nome, ricerca, punteggio minimo, modello.

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

Tipo: Scrittura. Scope: write.

ParametroTipoObbligatorioDescrizione
idstringNoStable slug; reuse it to update an existing campaign
namestringSì
searchobjectSì
minScoreintegerNo
templateIdstringNo
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#

Simula una campagna su offerte reali prima di seguirla. Nulla viene salvato.

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

Tipo: Lettura in diretta. Scope: explore.

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

followUpworkCampaign#

Chiede al Motor di seguire una campagna salvata, al suo ritmo di raccolta.

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

Tipo: Azione. Scope: act.

ParametroTipoObbligatorioDescrizione
campaignIdstringSì
namestringNoNom 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#

Impedisce al Motor di seguire una campagna. Le offerte già viste restano nella pipeline.

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

Tipo: Azione. Scope: act.

ParametroTipoObbligatorioDescrizione
campaignIdstringSì
namestringNoNom 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#

Aggiorna le campagne seguite: unisce le offerte raccolte dal Motor, rilegge in diretta la prima pagina, valuta le nuove offerte.

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

Tipo: Scrittura. Scope: write, explore.

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

checkUpworkOutcomes#

Rilegge le pagine delle candidature in corso per datare il loro esito: chiusa, colloqui avviati, nessuna risposta.

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

Tipo: Scrittura. Scope: write, explore.

ParametroTipoObbligatorioDescrizione
jobIdsarray<string>No
limitintegerNo
curl -s https://piqline.com/api/v1/tools/checkUpworkOutcomes \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

syncUpworkReplies#

Legge le e-mail di notifica di Upwork nelle caselle collegate del creatore della chiave e fa avanzare lo stato delle offerte della pipeline.

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

Tipo: Scrittura. Scope: write.

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

Una domanda sull'API, o un errore in questa pagina? Scrivici.