Ashby Agents

ashby agents can assist with taking actions on candidates and answering questions you may have about your pipeline, all in one place prerequisites and permissions agents provide information based on the user's permissions each user can only get information on jobs and candidates they already have access to elevated access users and organization admins can create and use personal agents only organization admins can create and edit shared agents limited access users do not have access to the ai agent options ashby agents are available on all plans foundations legacy plus plus enterprise ✅ ✅ ✅ ✅ see our ashby agents use case library docid\ amhhzven3gevexyxx2qt8 for specific prompts and use cases ashby assistant versus custom agents the ashby assistant and custom agents are both ai agents the ashby assistant is the default agent that opens when you click ashby ai this agent has no custom instructions and works best for ad hoc, one off tasks custom agents can be created by users in your ashby account you and other users create custom natural language instructions for your custom agent to follow these are best for repeatable workflows in your organization enabling ashby assistant and custom agents if you have auto enable new features toggled on for your organization, you can skip the steps below to enable ashby assistant and custom agents navigate to admin > organization setup > opt in features if you have not yet opted in to ai features, toggle on enable ai features you will be prompted to read and agree to ashby's ai terms before any ai features can be enabled toggle on custom agents the custom agents tile in opt in features accessing the ashby assistant you can access ai agents via the top navigation bar in your ashby account click ashby ai to the left of your user avatar to get started what can ashby agents and the assistant do? data sources they can read the ashby assistant and custom agents can read and pull information to answer questions on the following areas of ashby candidates interview plans jobs applications interviews feedback forms interview transcripts upcoming interviews openings available tools the ashby assistant and custom agents can take the following actions on your behalf you have final confirmation before any action is taken finding people and records search records by name resolves a name to a record supports candidates, jobs, applications, and email templates this is the starting point for most questions, such as "find the candidate jordan lee" or "pull up the senior designer job " filter records finds records matching specific criteria, and can return a total count instead of a list supports candidates, applications, jobs, job postings, openings, scheduled interviews, and offers for example "how many candidates are in the interview stage for the sales role" or "show me applications that involve me " describe object fields a behind the scenes helper that discovers which fields to filter on for a given record type before calling filter records you do not invoke this directly, but it is what lets filtering work reliably across all supported record types get record details pulls the full details of records you have already located supports jobs, job postings, applications, email templates, openings, scheduled interviews, and offers get candidate pulls information from a candidate's profile resume, interview feedback, emails, texts, notes, interview transcripts, referrals, follow ups, form submissions, and more use this for questions like "summarize this candidate's background" or "did this candidate mention anything about relocation?" list applications lists applications with optional filters, including across multiple jobs at once each result shows its own source and who it's credited to list available job postings lists your company's postings currently live on job boards, with visibility flags and posting urls finding people and records get referral history lists people you've referred, with candidate names, jobs, dates, and current stage covers form referrals by default, or referral link performance on request interviews and feedback get upcoming interviews lists your upcoming interviews with candidate names, job titles, times, and links ask "what interviews do i have this week?" get interview details pulls a detailed prep briefing for a specific interview candidate background, resume summary, the panel, and the hiring team use this right before an interview get interview plan shows the stages a candidate moves through for a given job or application get submitted feedback pulls up scorecard feedback you personally submitted for a candidate or interview this only shows your own feedback, not other interviewers' edit submitted feedback reopens a scorecard you've already submitted, pre filled with your prior answers, so you can revise and resave it fill form opens a form for you to complete and submit interview feedback, a referral, or a quality of hire survey pipeline and your to do list get job pipeline shows how many candidates are at each stage of a job's pipeline, and can compare multiple jobs at once ask "how is the pipeline looking for the engineering roles?" get pending tasks lists your pending tasks in ashby scorecards you owe, approvals waiting on you, follow ups, candidate reviews, and survey requests ask "what do i need to do today?" making changes create candidate creates a new candidate with name and contact details add note to candidate drafts a note on a candidate's profile for you to confirm before saving can also reply to an existing note change application stage moves a candidate's application to a different stage in the interview process for that job consider candidate for a job adds a candidate to a job by creating a new application at the first stage of that job's interview process email candidate drafts an email to a candidate for you to review, edit, and send configuring custom agents create custom agent creates a new custom agent from a name, description, and instructions update custom agent edits an existing custom agent's name, description, and/or instructions asking the ashby assistant a question the ashby assistant and agents generate responses, summaries, and recommendations based on the information available to them (see data sources docid 2zuvvixdetej4odp 5job above) ai generated content may be inaccurate and should be reviewed before use on the ai agent page, type your question or instructions in the ask the assistant field once you've entered your question, click the arrow button to submit your request the ashby assistant takes a moment to think, then responds if any action is to be taken (for example, adding a candidate), you are asked to approve the action before it is taken in the example below, click create candidate to confirm the action the ashby assistant should take if the suggested action isn't correct, click reject the agent does not take the proposed action and you can provide further instruction once an action has been taken, click the arrows to the right of each action to view the details for example, in a considered for job action, you can see the job title and candidate name listed in the dropdown with further details once all actions are complete, you are prompted for any further requests to start a new conversation, click + new chat custom agents you can create your own agents, either personal or shared across the organization, to help with repeatable actions these agents can also be tagged into questions with the ashby assistant the agent setup options and settings are in the bottom left corner of the ai agent page my agents click this to view your personal agents and set up new personal agents shared agents click this to view your organization's agents and set up new shared agents creating a custom agent to create a new agent, navigate to the my agents or shared agents page, then click + add x agent from here, a wizard guides you through the steps you have two options here generate a custom agent from a plain language description describe what your agent should do in plain language in the what should your agent do? field click generate draft ashby then generates a name, description, and instructions for your agent review the generated content and make any edits to the name, description, or instructions click continue to confirm determine the trigger and delivery settings then click create agent see triggers and delivery settings below for more information docid 7q8hhuip ukn5hlarypoh ashby assistant can also help you create or update agents more on this in available tools docid 2zuvvixdetej4odp 5job build a custom agent manually click build manually in the describe your agent step add the agent information in the review step add a name and description to your agent for reference add instructions for the agent in natural language the agent uses these every time it's triggered determine the triggers and delivery see triggers and delivery settings docid 2zuvvixdetej4odp 5job below for more information click create agent to confirm your settings and create your agent triggers and delivery settings when configuring a custom agent, you can either set the trigger to be an at mention directly in a conversation with the ashby assistant a recurring schedule with a set cadence and time agents with the schedule trigger can only take read actions and will always execute with the author's permissions if you select schedule as your trigger, you then need to determine the cadence and where the output is delivered you can set the cadence to daily, weekly, monthly, or quarterly, or choose a custom frequency you can set the day or date to send the output for weekly, quarterly, monthly, and custom options you can set the time and timezone for all cadence options you can deliver output via slack and/or email add slack users or channels in the add slack user or channel field using the dropdown and search options you can type an email into the email field and click + add to add email recipients recipients cannot reply to scheduled agent output directly in slack or email users need to click the continue in ashby button in their email or the link in their slack message to be taken to the ashby assistant to continue the conversation the screenshot shows the continue in ashby button that will show on emails sent by scheduled agents using a custom agent with the ashby assistant when asking a question or providing instructions to the ashby assistant, at mention your agent using the name you specified during the creation process once the appropriate agent has been selected from the list, it displays above your prompt a chat with the ashby agent using a custom agent alternatively, click use agent to view the full list of agents and add one to your prompt a chat with the ashby agent with the use agent button highlighted only one agent can be added to a request at a time editing a custom agent to edit a custom agent click the my agents or shared agents tab click on the agent in question amend the description and instructions fields as needed click save to confirm your changes disabling an active agent to disable an agent click the my agents or shared agents tab click on the agent in question click disable the option to disable a custom agent within the agent's settings you can re enable disabled agents by selecting the agent in your my agents or shared agents list and clicking enable in the panel showing the agent details converting personal agents to shared agents only organization admins can convert a personal agent to a shared agent if an agent is configured under my agents and you'd like to share it, click on the agent, then click more and convert to shared agent the more option within an agent's settings it is not currently possible to convert a shared agent back to a personal agent shared scheduled agents sharing a scheduled agent lets other users access it, but doesn't change the permissions it runs with it always runs with the author's permissions this means a shared agent can send information available to its author to the configured slack channel or email recipients to protect that access scheduled agents are read only; they do not take actions in ashby the agent author can send follow up messages in the in app conversation follow ups can use write tools, which are not available during the initial scheduled run slack and email delivery are one way recipients cannot reply to the agent from those destinations for agents configured to deliver output to slack or email, the link to open the conversation in ashby only works for the author other users cannot view the conversation in the app or send follow up messages only the author can edit an active scheduled agent only the author can change its instructions, schedule, or delivery destinations only the author can use run now or re enable the agent only the author can view the contents of previous agent runs other users with access to the agent can see the list of previous runs in the runs tab, but cannot open a run to see its contents an organization admin can disable another user's active shared scheduled agent, but cannot edit or restart it asking agents questions via slack if you use the slack integration, you can ask agents questions and request actions directly from the ashby apps channel for more on this, check out using ashby agents in slack docid\ z3id z7kseanuamptofjg reviewing previous conversations with ashby assistant when you have ashby assistant open, previous conversations will be listed under recents on the left hand side of the screen use the magnifying glass icon to search for specific conversations as needed the chat history with ashby assistant faqs can i run an agent with a schedule trigger outside of the schedule window? yes navigate to the created agent, then click run now to run the agent immediately you then see the agent running with a status this option is only available if the agent is enabled the screenshot shows an active agent with the run now button highlighted