> 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

L'Agente di reclutamento automatizza il reclutamento dei partner per il tuo programma, utilizzando l'IA per individuare nuovi potenziali partner dal [Marketplace](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/performance-program/recruiting-partners/marketplace-vs-direct-partner-recruiting-explained.md) e valutare per tuo conto le candidature ricevute. Si basa sull'approccio di reclutamento basato sui flussi di lavoro. Per l'alternativa basata su regole, consulta [Panoramica dei flussi di lavoro di reclutamento](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/automate-partner-application-processing/recruitment-workflows-explained.md). Per iniziare, consulta [Configurare l'Agente di reclutamento](https://help.impact.com/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:** L'Agente di reclutamento è in beta aperta ed è disponibile per i brand con programmi Performance, Creator o Amazon Seller.
{% endhint %}

## Scopri come funziona l'agente

L'agente coordina 3 sotto-agenti, ognuno dei quali gestisce una parte specifica del funnel di reclutamento. Ogni scheda del sotto-agente include un interruttore. Impostalo su ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[Toggle on]** per includere il sotto-agente nel funnel, oppure su ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FACIoqj1Ayhx8QzL9aqYB%2Ftoggle-off-solid%20\(1\).svg?alt=media\&token=a85366cd-4b70-41a6-83df-319f89597ede) **\[Toggle off]** per saltare quella parte del funnel. Puoi configurare ogni sotto-agente in modo indipendente. Consulta le sezioni sui sotto-agenti qui sotto.

L'agente si basa su un unico insieme di istruzioni che puoi controllare. Per sapere come scriverle e perfezionarle, consulta [Scrivere istruzioni efficaci per l'agente](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/write-effective-agent-instructions.md).

<details>

<summary>Sotto-agente Discover</summary>

Il sotto-agente Discover usa le istruzioni che fornisci per individuare, valutare e organizzare nuovi potenziali partner dal Marketplace di impact.com e aggiunge i migliori alla tua lista Prospects.

Avvia manualmente la ricerca selezionando **Run Discover** nella scheda dell'agente, oppure imposta un'esecuzione programmata. Mentre il sotto-agente è occupato, il testo del pulsante cambia in *In esecuzione* e il pulsante è disattivato. Al termine dell'esecuzione, attendi qualche minuto perché l'elaborazione finisca, quindi trova i partner aggiunti nella pagina *Prospects* impostando il filtro *Source* su *Recruitment Agent*. Consulta [Monitorare i risultati dell'Agente di reclutamento](https://help.impact.com/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:** Durante la beta puoi avviare la ricerca fino a 5 volte nell'arco di 24 ore, incluse le esecuzioni programmate.
{% endhint %}

Se visualizzi un messaggio che indica che **Run Discover** non è disponibile, una descrizione al passaggio del mouse ti informa che hai esaurito tutte le esecuzioni di ricerca per il periodo di 24 ore in corso. Potrai avviare di nuovo la ricerca al termine del periodo.

Se una ricerca restituisce pochissimi risultati o nessuna corrispondenza, rendi le istruzioni meno restrittive. Modificale e avvia di nuovo la ricerca.

Durante la ricerca, il sotto-agente consulta il Marketplace, valuta i candidati in base alle tue istruzioni e aggiunge i migliori alla tua lista *Prospects* con *Source = Recruitment Agent*, nel gruppo che hai impostato in Assegna gruppi. Per ogni potenziale partner aggiunto, l'agente lascia una nota nel registro delle attività del partner, spiegando perché è adatto. Consulta [Visualizzare i potenziali partner](https://help.impact.com/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 stabilisce che un partner non è adatto, lo esclude dalle esecuzioni successive per 6 mesi o finché non aggiorni le istruzioni, a seconda di quale evento si verifichi per primo. In questo modo la ricerca è più efficiente, perché evita di rivalutare partner che hai già escluso. Poiché una modifica delle istruzioni implica un cambiamento dei criteri di corrispondenza, l'intero elenco di esclusione viene reimpostato automaticamente.

Il sotto-agente Discover è preconfigurato. Prima di attivare l'agente, puoi rivedere e modificare i canali di ricerca, l'assegnazione ai gruppi, la pianificazione e il limite di esecuzioni. Consulta [Configurare l'Agente di reclutamento](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/set-up-the-recruitment-agent.md).

</details>

<details>

<summary>Sotto-agente Evaluate Applications</summary>

Il sotto-agente Evaluate Applications valuta automaticamente le candidature dei partner ricevute, applicando le regole delle tue istruzioni e offrendo la possibilità di tutelarti nei casi incerti.

Quando l'opzione *Garanzie di qualità e sicurezza* è attiva, l'agente valuta solo i partner che rispettano gli standard di sicurezza del Marketplace della piattaforma. Per impostazione predefinita, le candidature dei partner che non rispettano questi standard vengono rifiutate. Puoi modificare questa impostazione con l'opzione *Fallback in caso di mancato rispetto delle misure di sicurezza e qualità*  impostazione. L'agente applica subito questa soluzione di ripiego, sia in modalità Autopilot sia Copilot, e assegna la candidatura a un gruppo che indica perché è stata rifiutata o lasciata in sospeso. La scheda Evaluate Applications mostra *Obbligatorio* quando *Garanzie di qualità e sicurezza* è attivo e *Non obbligatorio* quando è disattivato. Vedi [Impostazioni di Evaluate Applications](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/set-up-the-recruitment-agent.md#evaluate-applications-settings).

Il sottoagente viene eseguito per ogni candidatura in arrivo, quindi non devi avviarlo manualmente. Prende decisioni entro pochi secondi dall'invio della candidatura.

Puoi impostare il livello di autonomia del sottoagente:

* **Autopilot** (consigliato): l'agente confronta ogni candidatura con le tue istruzioni e i dati del partner, quindi accetta o rifiuta le corrispondenze chiare e lascia al tuo team la revisione delle candidature ambigue.
* **Copilot:** l'agente consiglia di accettare o rifiutare ogni candidatura assegnandola a un gruppo; spetta a te prendere la decisione finale dalla pagina [*Candidature*](https://app.impact.com/secure/advertiser/engage/contracts/activity/adv-manage-pending-public-ios-v2-flow.ihtml) . Se non intervieni entro 7 giorni, l'agente applica la sua raccomandazione per te. Vedi [Esaminare le candidature di partner e creator](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/review-partner-and-creator-applications.md).

Se hai appena iniziato, usa la modalità Copilot per verificare le tue istruzioni e perfezionarle finché i consigli dell'agente non corrispondono con costanza a ciò che desideri.

Ogni volta che l'agente accetta o rifiuta una candidatura, oppure consiglia una decisione, aggiunge una nota al registro attività della candidatura spiegandone il motivo. Vedi [Monitorare i risultati dell'agente di reclutamento](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/track-recruitment-agent-results.md#see-the-applications-the-agent-evaluated).

I rifiuti includono un motivo strutturato, così vengono riportati correttamente nei report esistenti e nel token email `{rejectReason}` .

**Modificare una decisione presa dall'agente.** Se per una candidatura che l'agente ha accettato o rifiutato serve un esito diverso, seleziona **Esamina la decisione** nella relativa riga della scheda **Elaborate** della pagina [**Candidature**](https://app.impact.com/secure/advertiser/engage/contracts/activity/adv-manage-pending-public-ios-v2-flow.ihtml) . Puoi modificare una decisione entro 6 mesi dalla data in cui è stata presa. Correggendo un rifiuto, il partner viene accettato immediatamente: non serve inviare un nuovo invito né aspettare una sua risposta, quindi una decisione errata non ti fa perdere opportunità. Vedi [Modificare la decisione su una candidatura elaborata](https://help.impact.com/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 sottoagente Evaluate Applications è preconfigurato. Puoi esaminare e modificare le sue misure di sicurezza, il livello di autonomia e l'assegnazione ai gruppi prima di attivare l'agente. Vedi [Configurare e attivare l'agente](https://help.impact.com/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).

</details>

<details>

<summary>Invitare potenziali partner (in arrivo)</summary>

Il sottoagente Invite Prospects compare nella configurazione dell'agente con l'etichetta In arrivo. Per inviare un'email ai potenziali partner aggiunti dall'agente Discover, usa un flusso di lavoro email:

1. Crea un segmento di partner che includa i potenziali partner aggiunti da Discover. Vedi [Contattare i potenziali partner aggiunti dall'agente di reclutamento](https://help.impact.com/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) in Segmenti di partner per Scopri i flussi di lavoro email.
2. Crea un flusso di lavoro email personalizzato che utilizzi quel segmento e aggiungi il tuo messaggio. Vedi [Creare e gestire flussi di lavoro email](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/email-workflows/create-and-manage-email-workflows.md).
3. Se vuoi, invia i messaggi dal tuo indirizzo email invece che dall'indirizzo generico di impact.com. Vedi [Collegare il tuo indirizzo email personale al tuo account impact.com](https://help.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 sarà disponibile tra le opzioni quando configuri l'email del flusso di lavoro.

</details>

## Proteggere il tuo brand

L'agente di reclutamento non aggiungerà al tuo programma i seguenti partner:

* I partner presenti nella tua [lista di blocco](https://help.impact.com/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).
* I partner segnalati per comportamenti fraudolenti.

Puoi aggiungere un ulteriore livello di protezione attivando *le protezioni di qualità e sicurezza* nel sottoagente Evaluate Applications. Vedi [Configurare l'agente di reclutamento](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/set-up-the-recruitment-agent.md).

## Scopri come integrare l'agente con l'automazione esistente

Se già utilizzi [i workflow delle candidature](https://help.impact.com/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 webhook per le candidature, l'agente di reclutamento segue un ordine definito, così l'automazione esistente continua a funzionare come previsto.

{% hint style="success" %}
**Nota:** L'accesso ai workflow dipende dal piano. I workflow delle candidature sono disponibili nei piani Essential, Pro ed Enterprise, mentre i workflow email sono disponibili nei piani Pro ed Enterprise. I piani Starter e Starter Agency non includono l'accesso ai workflow.
{% endhint %}

Le candidature vengono valutate nel seguente ordine:

1. **Controlli di sicurezza della piattaforma.** Per prima cosa vengono eseguiti i controlli di sicurezza di base.
2. **Impact AI.**
3. **Workflow delle candidature.** L'automazione basata su regole.
4. **L'agente di reclutamento e il webhook per le candidature.** L'agente valuta le candidature rimaste in sospeso dopo i passaggi precedenti. Contemporaneamente, il webhook per le candidature invia la candidatura all'endpoint configurato in [callback di notifica degli eventi](https://help.impact.com/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 decisioni autonomamente. Puoi inviare le decisioni usando l'API di elaborazione delle candidature.

L'agente di reclutamento non sovrascrive mai una decisione già presa dai passaggi precedenti. Se un revisore interviene manualmente su una candidatura prima che l'agente abbia terminato, prevale la decisione manuale.

{% hint style="success" %}
**Nota:** Poiché l'agente di reclutamento e il webhook per le candidature vengono eseguiti contemporaneamente, il webhook potrebbe inviare la candidatura prima che l'agente abbia terminato la valutazione. Per fare in modo che l'agente decida per primo, aggiungi un ritardo al webhook nella relativa configurazione, nella pagina Impostazioni. Il webhook invierà quindi la candidatura dopo il ritardo, includendo la decisione dell'agente.
{% endhint %}

Se le tue istruzioni includono regole rigide e deterministiche, ad esempio «non accettare partner al di fuori degli Stati Uniti», valuta di aggiungerle anche come workflow delle candidature. I workflow sono più veloci e non consumano la capacità dell'agente per decisioni che non richiedono ragionamento.

Per ulteriori informazioni sull'ordine dei workflow, vedi [Impostare l'ordine di esecuzione dei workflow delle candidature](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/automate-partner-application-processing/set-application-workflow-execution-order.md).

## Gestire gli agenti

La pagina *Agenti* elenca tutti gli agenti che hai attivato. Durante la fase Beta puoi configurare un agente di reclutamento.

1. Nel menu di navigazione a sinistra, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FfNdtzoQPSDPM4YuEPJSl%2Fagents.svg?alt=media\&token=4b2dbc3b-4ef9-4e55-a1e0-1ce46f425e9b) [**\[Agenti\]**](https://app.impact.com/secure/advertiser/agents/fr/agent-marketplace.ihtml).
   * L'agente viene visualizzato in una scheda che ne mostra lo stato, l'ultimo aggiornamento e le azioni rapide.
2. Nella scheda dell'agente, scegli un'azione:
   * Seleziona **Modifica** per aprire l'agente e modificarne le impostazioni.
   * Seleziona **Avvia Discovery** per avviare un'esecuzione di Discovery.
   * Passa il cursore sulla scheda, quindi seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FaMIlbqH54V4Ow5JvT0I0%2F%5BMore%5D%20vNext%202.svg?alt=media\&token=6d5449e8-e413-48fa-b059-58ebb3e2c271) **\[Altro]** per altre azioni:
     * **Visualizza report:** Apri *Panoramica dell'agente*, un riepilogo delle esecuzioni di Discovery, delle decisioni sulle candidature e delle prestazioni dell'agente. Vedi [Monitorare i risultati dell'agente di reclutamento](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/track-recruitment-agent-results.md#see-your-agents-overview).
     * **Visualizza i potenziali candidati individuati:** Apri *Potenziali candidati* pagina, filtrata per mostrare i potenziali candidati aggiunti dal sottoagente Discover.
     * **Visualizza le candidature valutate:** Apri la pagina *Candidature* pagina, filtrata per mostrare le candidature valutate dall’agente. Consulta [Monitorare i risultati dell’agente di reclutamento](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/track-recruitment-agent-results.md).
     * **Metti in pausa:** Interrompe le esecuzioni pianificate di Discovery e la valutazione delle candidature in ingresso. I potenziali candidati e le candidature esistenti non vengono modificati.
     * **Elimina:** Rimuove l’agente.

Per trovare i risultati dell’agente, consulta [Monitorare i risultati dell’agente di reclutamento](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/track-recruitment-agent-results.md).

### Aggiornare le impostazioni dell’agente

Puoi modificare la configurazione di un agente attivo in qualsiasi momento. Nella pagina *Agenti* seleziona **Modifica** sulla scheda dell’agente, quindi apporta una delle seguenti modifiche:

* Per rinominare l’agente, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F4lDm9hd6ePtF5al1oSaY%2F%5BEdit%5D.svg?alt=media\&token=70cab547-2f88-4901-861d-c832f66ac391) **\[Modifica]** accanto al nome dell’agente nella parte superiore della pagina.
* Per modificare le istruzioni, seleziona **Modifica** nel riquadro *Istruzioni dell’agente* Consulta [Scrivere istruzioni efficaci per l’agente](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/write-effective-agent-instructions.md).
* Seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[Attiva]** oppure ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FACIoqj1Ayhx8QzL9aqYB%2Ftoggle-off-solid%20\(1\).svg?alt=media\&token=a85366cd-4b70-41a6-83df-319f89597ede) **\[Disattiva]** sulla scheda di un sottoagente per includerlo nel funnel o metterlo in pausa. Per modificare le impostazioni di un sottoagente, seleziona **Modifica** sulla relativa scheda. Consulta [Configurare l’agente di reclutamento](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/set-up-the-recruitment-agent.md) per scoprire a cosa serve ogni impostazione.

Dopo aver salvato le modifiche a livello di sottoagente, 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 best practice

* Esegui dei test prima di procedere. Verifica le istruzioni con una breve esecuzione di Discover e avvia il sottoagente Evaluate Applications in modalità Copilot prima di aumentare la scala o passare ad Autopilot. Consulta [Scrivere istruzioni efficaci per l’agente](https://help.impact.com/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 ai fini dei clic. Puoi farlo in due modi:
  * Nel [*Report sulla produttività dei partner*](https://help.impact.com/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 aver aderito al tuo programma.
  * Nella schermata *Candidature* , imposta il filtro **Elaborato da** su **Agente di selezione** per visualizzare tutte le candidature valutate dall’agente.
* Contatta i partner appena aggiunti che hanno già generato clic usando [Flussi di lavoro email](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/email-workflows.md) per aiutarli a compiere i prossimi passi mentre entrano a far parte del tuo programma.
* [Fai scadere i contratti](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/contracts/expire-partner-contracts.md) dei partner non 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=<question>&goal=<user_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.
