> 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/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/set-up-the-recruitment-agent.md).
# Set Up the Recruitment Agent
This article walks through setting up and activating your Recruitment Agent, and explains the settings for each sub-agent. For an overview of the agent and how it works, see [Recruitment Agent](/brand/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent.md). For how to write the instructions the agent runs on, see [Write Effective Agent Instructions](/brand/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/write-effective-agent-instructions.md).
{% hint style="warning" %}
**Beta:** The Recruitment Agent is in Open Beta and is available to brands with Performance, Creator, or Amazon Seller programs.
{% endhint %}
## Set up & activate the agent
Follow these steps to set up and activate your Recruitment Agent.
{% stepper %}
{% step %}
### Open the Browse Agents page
1. From the left navigation menu, select  [**\[Agents\]**](https://app.impact.com/secure/advertiser/agents/fr/agent-marketplace.ihtml).
* If you already have an active agent, select **Browse Agents** in the top right.
2. Under *Task agents*, select the **Recruitment Agent** tile.
{% endstep %}
{% step %}
### Set up your agent
1. Optionally, update the **Agent Name**. The default is "Recruitment Agent."
2. In **Your website URL**, enter your brand's website URL. It is pre-populated, and you can change it to any URL you want. A page with detailed brand information, such as an About us page, can help the agent build more accurate instructions.
3. Select **Configure Agent**.
* impact.com uses AI to generate your starting instructions from your website and Marketplace Profile. This takes around 10–15 seconds.
* If the AI cannot generate your instructions, for example because your brand URL is unreachable, you can write them manually. See [Write Effective Agent Instructions](/brand/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/write-effective-agent-instructions.md).
{% endstep %}
{% step %}
### Review and edit your instructions
1. On the funnel, in the *Agent Instructions* panel, select **Edit**.
2. Review the generated **Instructions**. See [Write Effective Agent Instructions](/brand/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/write-effective-agent-instructions.md) for guidance.
3. Optionally, select **Evaluate Instructions** to have AI score your instructions and suggest improvements. See [Evaluate your instructions](/brand/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/write-effective-agent-instructions.md#evaluate-your-instructions).
4. Select **Save**.
{% endstep %}
{% step %}
### Configure the sub-agents
1. On a sub-agent card, set the toggle to  **\[Toggle on]** or .svg?alt=media\&token=a85366cd-4b70-41a6-83df-319f89597ede) **\[Toggle off]**.
2. Select **Edit** to open the sub-agent's settings.
3. Adjust the settings, then select **Save**. See the [*Discover settings*](#discover-settings) and [*Evaluate Applications settings*](#evaluate-applications-settings) references below.
4. Select **Update** in the top right of the page to apply your changes.
{% hint style="warning" %}
**Important:** Selecting **Save** in a sub-agent's slideout does not save your changes on its own. To keep them, you must also select **Update** in the top right, or **Activate Agent** if this is the first time you are setting up the agent. If you leave the page without doing so, your changes are not saved.
{% endhint %}
{% endstep %}
{% step %}
### Activate your agent
Select **Activate Agent** in the top right.
After you activate the agent, it moves to the *Agents* page and begins working. Scheduled Discovery runs start from the next scheduled time, and the Evaluate Applications sub-agent starts processing new inbound applications.
{% endstep %}
{% endstepper %}
## Edit the sub-agent settings
Each sub-agent comes pre-configured. You can change its settings during setup or any time after you activate the agent.
1. From the left navigation menu, select  [**\[Agents\]**](https://app.impact.com/secure/advertiser/agents/fr/agent-marketplace.ihtml).
2. On your agent’s card, select **Edit**.
3. On the sub-agent’s card, select **Edit**.
4. Adjust the settings, then select **Save**. Expand a sub-agent below to see what each setting does.
5. Select **Update** in the top right to apply your changes.
Discover settings
* **Sourcing channels:** choose where the sub-agent looks for new partners.
* **impact.com Marketplace**: searches for partners already on the impact.com network. Proposals are sent within the impact.com platform and are likely to have higher conversions.
* **Assign groups:** when set to  **\[Toggle on]**, the agent automatically assigns newly discovered prospects to a group. This defaults to the Recruitment Agent: Discover group.
* **Schedule Run Cadence:** set a schedule to discover new partners automatically. If it is set to **\[Toggle off]**, you can still run Discovery manually using **Run Discover**. For Beta, you can run Discovery up to 5 times in a 24-hour period, including scheduled runs.
* **Maximum Run Limit:** set the per-run cap using the slider, from 10–50, with a default of 30. This gives you predictable batch sizes instead of an open-ended stream of new prospects.
Evaluate Applications settings
* **Agent Autonomy:** select **Autopilot** to have the agent compare each application against your instructions and the partner's data, then accept or reject clear matches, or **Copilot** to have the agent recommend accepting or rejecting each application by assigning it to a group while you make the final decision. In Copilot, if you don't act within 7 days, the agent applies its recommendation for you.
* **Group partners:** the agent assigns a group to each application once it evaluates it. You can customize the group name used for each outcome. The fields depend on your *Agent Autonomy* setting:
* **Autopilot:** set the toggle to  **\[Toggle on]** to assign groups. The **Accepted**, **Pending**, and **Rejected** fields default to “Accepted by Recruitment Agent,” “Left pending by Recruitment Agent,” and “Rejected by Recruitment Agent.”
* **Copilot:** the **Recommend to Accept**, **Recommend to Leave Pending**, and **Recommend to Reject** fields default to “Recruitment Agent suggests: accept,” “Recruitment Agent suggests: pending,” and “Recruitment Agent suggests: reject.”
* **Quality & Safety Guardrails** (recommended): vet new partner sign-ups against the platform's Marketplace standards, so you focus on high-quality applications. On average, the top 40% of partners meet these standards. A partner that meets these standards is [*Marketplace approved*](/brand/what-would-you-like-to-learn-about/performance-program/recruiting-partners/marketplace-vs-direct-partner-recruiting-explained.md)*.* These checks look at signals such as identity and contact details, media properties, audience authenticity, content safety, traffic quality, and risk indicators; impact.com sets and maintains the exact criteria and thresholds. Turning this setting on also turns on the [*Partner Verification*](/brand/what-would-you-like-to-learn-about/performance-program/recruiting-partners/screen-partners-automatically-with-partner-verification.md) setting; turning it off does not turn Partner Verification off. You can find Partner Verification in your Partner Signup Page settings.
* **Fallback if Quality & Safety Guardrails Fail:** set what the agent does with applications from partners that do not meet the Marketplace standards. The agent applies this action immediately, in both Autopilot and Copilot. Select one of the following:
* **Leave Pending**: leave these applications pending for you to review manually.
* **Reject** (default)**:** reject these applications automatically.
---
# 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/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/set-up-the-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.
