Ivy is your AI copilot inside Intervy. Open the Ivy panel from any screen to draft questions, build templates, review candidate profiles, and get answers about how Intervy works — all without leaving your current context.
What Ivy can do
Ivy operates a multi-turn tool-use loop. She reads context from your organization, calls tools to fetch or create data, and returns structured results. Each round may invoke multiple tools before producing a response.
Tools
Ivy has access to 17 tools grouped by function:
Read-only tools
| Tool | What it does |
|---|---|
search_docs | Search the Intervy documentation by semantic query |
get_question | Fetch a single question from the library by ID |
search_questions | Search the question library by keyword or filter |
get_template | Fetch a single interview template by ID |
search_templates | Search templates by name or content |
get_interview | Fetch a single interview record |
search_interviews | Search interviews by candidate, phase, or status |
get_organizations | Fetch details about the current organization |
get_org_members | List members of the organization |
Draft tools (create and edit)
| Tool | What it does |
|---|---|
draft_question | Create a new draft question in the session |
update_draft_question | Edit a draft question in the session |
remove_draft_question | Remove a draft question from the session |
draft_template | Create a new draft template in the session |
update_draft_template | Edit a draft template in the session |
assign_questions_to_template | Add questions to a draft template |
draft_interview_question | Add a draft question to a live interview |
update_draft_interview_question | Edit a draft interview question |
remove_draft_interview_question | Remove a draft interview question |
BYOK setup
Bring Your Own Key (BYOK) lets your organization route all Ivy requests through members' own Anthropic or OpenAI API keys instead of Intervy credits. BYOK is available on Growth plans and above.
Step 1 — Enable BYOK (Org Admin only)
- Open Organization Settings → AI (requires Org Admin role).
- Under Ivy AI provider, choose Anthropic or OpenAI.
- Confirm the switch in the dialog that appears.
- Click Save changes. Ivy immediately switches to BYOK mode for everyone in the organization.
Step 2 — Each member adds their personal key
Once BYOK is active, every member must add their own API key:
- Open Settings → General.
- Under Ivy → Personal API keys, select the Anthropic key or OpenAI key tab.
- Paste your key and click Test to verify it.
Permissions reference
Chat with Ivy is gated only by organization membership — every member can open the panel and send messages. Specific tools may require additional permissions:
| Action | Permission | Default roles |
|---|---|---|
| Use the classify_questions tool | questions:update | AdminStaffing |