> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent.md).
# Agente di reclutamento
Il Recruitment Agent automatizza il reclutamento dei partner per il tuo programma, usando l'IA per reperire nuovi prospect dal [Marketplace](/brand/it/what-would-you-like-to-learn-about/performance-program/recruiting-partners/marketplace-vs-direct-partner-recruiting-explained.md) e valutare le candidature in arrivo per tuo conto. Si basa sull'approccio di reclutamento basato sui workflow. Per l'alternativa basata su regole, vedi [Spiegazione dei workflow di reclutamento](/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/automate-partner-application-processing/recruitment-workflows-explained.md). Per iniziare, vedi [Configura il Recruitment Agent](/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/set-up-the-recruitment-agent.md).
{% hint style="warning" %}
**Beta:** Il Recruitment Agent è in beta ed è disponibile per un numero limitato di brand con programmi Performance, Creator o Amazon Seller.
{% endhint %}
## Comprendi come funziona l'agente
L'agente coordina 3 sotto-agenti e ciascuno gestisce una parte specifica del funnel di reclutamento. Ogni scheda del sotto-agente ha un interruttore. Impostalo su  **\[Attiva]** per includere il sotto-agente nel funnel, oppure .svg?alt=media\&token=a85366cd-4b70-41a6-83df-319f89597ede) **\[Disattiva]** per saltare quella parte del funnel. Configuri ogni sotto-agente in modo indipendente.
L'agente funziona a partire da un unico insieme di istruzioni che controlli tu. Per sapere come scriverle e perfezionarle, vedi [Scrivi istruzioni efficaci per l'agente](/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/write-effective-agent-instructions.md).
Sotto-agente Discover
Il sotto-agente Discover usa le istruzioni che fornisci per reperire, valutare e organizzare nuovi prospect dal Marketplace di impact.com e aggiunge i migliori abbinamenti alla tua lista Prospect.
Avvia Discovery manualmente selezionando **Esegui Discover** sulla scheda dell'agente, oppure impostalo per l'esecuzione pianificata. Mentre il sotto-agente è occupato, il testo del pulsante cambia in *In esecuzione* e il pulsante è disabilitato. Dopo il completamento di un'esecuzione, attendi qualche minuto che termini l'elaborazione, quindi trova i partner che ha aggiunto nella *Prospects* pagina impostando il *Origine* filtro su *Recruitment Agent*. Vedi [Monitora i risultati del Recruitment Agent](/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/track-recruitment-agent-results.md).
{% hint style="success" %}
**Nota:** Per la beta, puoi eseguire Discovery fino a 5 volte in un periodo di 24 ore, comprese le esecuzioni pianificate.
{% endhint %}
Se ricevi un messaggio che **Esegui Discover** non è disponibile, un tooltip ti informa che hai usato tutte le esecuzioni di Discovery per il periodo corrente di 24 ore. Potrai eseguire di nuovo Discovery al termine di quel periodo.
Se un'esecuzione di Discovery restituisce pochissimi o nessun abbinamento, allenta le istruzioni. Modificale ed esegui di nuovo Discovery.
Quando Discovery viene eseguito, il sotto-agente cerca nel Marketplace, valuta i candidati in base alle tue istruzioni e aggiunge i migliori abbinamenti alla tua *Prospects* lista con *Origine = Recruitment Agent*, nel gruppo che hai impostato in Assegna gruppi. Per ogni prospect che aggiunge, l'agente lascia una nota nel registro Attività del partner spiegando perché il prospect è adatto. Vedi [Visualizza i partner potenziali](/brand/it/what-would-you-like-to-learn-about/performance-program/recruiting-partners/prospective-partners/view-prospective-partners.md#view-the-partners-basic-information).
Quando il sotto-agente determina che un partner non è adatto, lo salta nelle esecuzioni future per 6 mesi o fino a quando aggiorni le tue istruzioni, a seconda di cosa accade prima. Questo mantiene Discovery efficiente evitando di rivalutare i partner che hai già escluso. Poiché una modifica nelle tue istruzioni significa che i criteri di corrispondenza sono cambiati, l'intera lista di esclusione viene reimpostata automaticamente.
Il sotto-agente Discover viene preconfigurato. Puoi rivedere e modificare i suoi canali di sourcing, l'assegnazione al gruppo, la pianificazione e il limite di esecuzione prima di attivare l'agente. Vedi [Configura il Recruitment Agent](/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/set-up-the-recruitment-agent.md).
Sotto-agente Valuta le candidature
Il sotto-agente Valuta le candidature valuta automaticamente le candidature dei partner in arrivo usando le regole delle tue istruzioni, con l'opzione di mettere in sicurezza gli abbinamenti incerti.
Quando *Barriere di protezione per qualità e sicurezza* è attivo, l'agente valuta solo i partner che soddisfano gli standard di sicurezza del Marketplace della piattaforma. Per impostazione predefinita, le candidature dei partner che non soddisfano questi standard vengono rifiutate, e puoi modificare questo comportamento con l'impostazione *Fallback se le barriere di qualità e sicurezza falliscono* . L'agente applica subito questo fallback, sia in Autopilot sia in Copilot. La scheda Valuta le candidature mostra *Richiesto* quando *Barriere di protezione per qualità e sicurezza* è attivo, e *Non richiesto* quando è disattivato.
Il sotto-agente viene eseguito su ogni candidatura in arrivo, quindi non lo attivi manualmente. Prende decisioni in pochi secondi dall'invio della candidatura.
Decidi quanta autonomia ha il sotto-agente:
* **Autopilot** (consigliato): l'agente confronta ogni candidatura con le tue istruzioni e i dati del partner, quindi accetta o rifiuta gli abbinamenti chiari e lascia le candidature ambigue al tuo team per la revisione.
* **Copilot:** l'agente consiglia di accettare o rifiutare ogni candidatura assegnandola a un gruppo, e tu prendi la decisione finale dalla [*Candidature*](https://app.impact.com/secure/advertiser/engage/contracts/activity/adv-manage-pending-public-ios-v2-flow.ihtml) pagina. Se non intervieni entro 7 giorni, l'agente applica per te la propria raccomandazione. Vedi [Esamina le candidature di partner e creator](/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/review-partner-and-creator-applications.md).
Se stai iniziando, usa la modalità Copilot così puoi convalidare le tue istruzioni e perfezionarle finché le raccomandazioni dell'agente non corrispondono costantemente a ciò che desideri.
I rifiuti includono un motivo di rifiuto strutturato, così confluiscono correttamente nei tuoi report esistenti e nel `{rejectReason}` token email.
**Cambia una decisione presa dall'agente.** Se hai bisogno di un esito diverso per una candidatura che l'agente ha accettato o rifiutato, seleziona **Rivedi decisione** nella sua riga nella **Elaborate** scheda della [**Candidature**](https://app.impact.com/secure/advertiser/engage/contracts/activity/adv-manage-pending-public-ios-v2-flow.ihtml) pagina. Puoi cambiare una decisione entro 6 mesi dal momento in cui è stata presa. Correggere un rifiuto accetta immediatamente il partner, senza bisogno di un nuovo invito e senza attendere una sua risposta, quindi una decisione errata non ti fa perdere alcuna opportunità. Vedi [Modifica la tua decisione su una candidatura elaborata](/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/process-partners-in-bulk-and-reverse-rejections.md#change-your-decision-on-a-processed-application) per entrambi i flussi.
Il sotto-agente Valuta le candidature viene preconfigurato. Puoi rivedere e modificare le sue barriere di sicurezza, autonomia e assegnazione al gruppo prima di attivare l'agente. Vedi [Configura e attiva l'agente](/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/set-up-the-recruitment-agent.md#set-up-and-activate-the-agent).
Invita i prospect (Prossimamente)
Il sotto-agente Invita i prospect appare nella configurazione dell'agente con l'etichetta Prossimamente. Per inviare email ai prospect aggiunti da Discover, usa un workflow email:
1. Configura un segmento partner che raggiunga i prospect aggiunti da Discover. Vedi [Contatta i prospect aggiunti dal Recruitment Agent](/brand/it/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/email-workflows/partner-segments-for-email-workflows-explained.md#reach-out-to-prospects-added-by-the-recruitment-agent) nei Segmenti partner in Spiegazione dei workflow email.
2. Crea un workflow email personalizzato che utilizzi quel segmento e aggiungi la tua email di contatto. Vedi [Crea e gestisci i workflow email](/brand/it/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/email-workflows/create-and-manage-email-workflows.md).
3. Facoltativamente, invia dal tuo indirizzo email invece che dall'indirizzo generico di impact.com. Vedi [Collega la tua email personale al tuo account impact.com](/brand/it/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/emails/connect-your-personal-email-to-your-impactcom-account.md). Una volta collegato, il tuo indirizzo appare come opzione quando configuri l'email del workflow.
## Proteggi il tuo brand
Il Recruitment Agent non aggiungerà al tuo programma i seguenti partner:
* Partner nella tua [lista di blocco](/brand/it/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/partner-management/block-partners-from-re-applying-to-your-program.md).
* Partner segnalati per comportamento fraudolento.
Puoi aggiungere un ulteriore livello di protezione abilitando **Barriere di protezione per qualità e sicurezza** nel sotto-agente Valuta le candidature. Vedi [Configura il Recruitment Agent](/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/set-up-the-recruitment-agent.md).
## Scopri come l'agente si integra con la tua automazione esistente
Se già usi [Workflow delle candidature](/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/automate-partner-application-processing/create-workflows-to-automatically-process-partner-applications.md), Impact AI o un Application Webhook, il Recruitment Agent si inserisce in un ordine definito così la tua automazione esistente continua a funzionare come previsto.
{% hint style="success" %}
**Nota:** L'accesso ai workflow dipende dalla tua edizione. I Workflow delle candidature sono disponibili nelle edizioni Essential, Pro ed Enterprise, mentre i Workflow email sono disponibili nelle edizioni Pro ed Enterprise. Le edizioni Starter e Starter Agency non hanno accesso ai workflow.
{% endhint %}
Le candidature vengono valutate in quest'ordine:
1. **Controlli di sicurezza della piattaforma.** I controlli di sicurezza di base vengono eseguiti per primi.
2. **Impact AI.**
3. **Workflow delle candidature.** La tua automazione basata su regole.
4. **Recruitment Agent e il tuo Application Webhook.** L'agente valuta le candidature lasciate in sospeso dalle fasi precedenti. Allo stesso tempo, il tuo Application Webhook invia la candidatura all'endpoint che configuri in [postback di notifica eventi](/brand/it/what-would-you-like-to-learn-about/account-administration/account-settings/notifications/enable-event-notification-postbacks-for-brands.md#notification-events-and-payloads). Il Webhook non prende da solo una decisione. Puoi inviare le decisioni tramite l'Application Processing API.
Il Recruitment Agent non sostituisce mai una decisione già presa dalle fasi sopra. Se un revisore manuale interviene su una candidatura prima che l'agente abbia finito, la decisione manuale ha la precedenza.
{% hint style="success" %}
**Nota:** Poiché il Recruitment Agent e il tuo Application Webhook vengono eseguiti contemporaneamente, il tuo Webhook potrebbe inviare la candidatura prima che l'agente finisca di valutarla. Per fare in modo che decida prima l'agente, aggiungi un ritardo al tuo Webhook nella configurazione del Webhook nella pagina Impostazioni. Il tuo Webhook invierà quindi la candidatura dopo il ritardo, includendo la decisione dell'agente.
{% endhint %}
Se le tue istruzioni includono regole rigide e deterministiche, come "non accettare partner fuori dagli USA", considera di aggiungerle anche come Workflow delle candidature. I workflow sono più veloci e non consumano capacità dell'agente per decisioni che non richiedono ragionamento.
Per maggiori informazioni sull'ordine dei workflow, vedi [Imposta l'ordine di esecuzione dei workflow delle candidature](/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/automate-partner-application-processing/set-application-workflow-execution-order.md).
## Gestisci i tuoi agenti
Il *Agenti* pagina elenca tutti gli agenti che hai attivato. Nella beta, puoi configurare 1 agente di reclutamento.
1. Dal menu di navigazione a sinistra, seleziona  [**Agenti**](https://app.impact.com/secure/advertiser/agents/fr/agent-marketplace.ihtml).
* Il tuo agente appare come una scheda che mostra il suo stato, l'ultimo aggiornamento e azioni rapide.
2. Nella scheda del tuo agente, scegli un'azione:
* Seleziona **Visualizza** per aprire l'agente e modificarne le impostazioni.
* Seleziona **Esegui Discover** per avviare un'esecuzione di Discovery.
* Seleziona  **\[Altro]** per altre azioni:
* **Visualizza i prospect trovati:** apri la *Prospects* pagina, filtrata sui prospect aggiunti dal sotto-agente Discover.
* **Visualizza le candidature valutate:** apri la *Candidature* pagina, filtrata sulle candidature valutate dall'agente. Vedi [Monitora i risultati del Recruitment Agent](/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/track-recruitment-agent-results.md).
* **Metti in pausa:** interrompi le esecuzioni programmate di Discovery e la valutazione delle candidature in arrivo. I prospect e le candidature esistenti non vengono influenzati.
* **Elimina:** rimuovi l'agente.
Per trovare i risultati del tuo agente, vedi [Monitora i risultati del Recruitment Agent](/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/track-recruitment-agent-results.md).
### Aggiorna le impostazioni del tuo agente
Quando apri un agente attivo, puoi modificarne la configurazione in qualsiasi momento.
* Per rinominare l'agente, seleziona  **\[Modifica]** accanto al nome dell'agente nella parte superiore della pagina.
* Per modificare le tue istruzioni, seleziona **Modifica** nel *Istruzioni dell'agente* pannello. Vedi [Scrivi istruzioni efficaci per l'agente](/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/write-effective-agent-instructions.md).
* Seleziona  **\[Attiva]** o .svg?alt=media\&token=a85366cd-4b70-41a6-83df-319f89597ede) **\[Disattiva]** sulla scheda di un sotto-agente per includerlo nel funnel o metterlo in pausa. Per modificare le impostazioni di un sotto-agente, seleziona **Modifica** sulla sua scheda. Vedi [Configura il Recruitment Agent](/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/set-up-the-recruitment-agent.md) per sapere a cosa serve ogni impostazione.
Dopo aver salvato le modifiche a livello di sotto-agente, seleziona **Aggiorna** nell'angolo in alto a destra per applicarle.
Le modifiche si applicano alle future esecuzioni di Discovery e alle future valutazioni delle candidature. L'agente non riapre le decisioni passate.
## Segui le buone pratiche
* Testa prima di procedere. Convalida le tue istruzioni con una piccola esecuzione di Discover e avvia il sotto-agente Valuta le candidature in modalità Copilot, prima di aumentare la scala o passare ad Autopilot. Vedi [Scrivi istruzioni efficaci per l'agente](/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/write-effective-agent-instructions.md).
* Esamina i partner quando diventano attivi sui clic. Puoi farlo in 2 modi:
* Nel [*Rapporto sulla produttività dei partner*](/brand/it/what-would-you-like-to-learn-about/performance-program/performance-program-reports/partner-productivity-report-for-brands.md), fai riferimento a *Nome partner* e *Data del primo clic* per vedere quando un partner ha generato il primo clic dopo essersi unito al tuo programma.
* Nella *Candidature* schermata, filtra per **Elaborato da = Recruitment Agent** per vedere tutte le candidature su cui l'agente ha preso una decisione.
* Contatta i partner attivi sui clic appena aggiunti usando [Workflow email](/brand/it/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/email-workflows.md) per supportare i loro prossimi passi mentre si uniscono al tuo programma.
* [Fai scadere i contratti](/brand/it/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/contracts/expire-partner-contracts.md) per i partner che non sono adatti, quindi aggiorna le tue istruzioni per ridurre errori simili nelle valutazioni future.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.