answer_education_question
ChatGPTAnswer the current school clarification using exact keys, versions and option IDs. Ask again for items with review_required even when resolved; previous_options remain valid choices. Complete the review with choices for every non-removed item that requires review or is not resolved, using education.revision and each request_version. Returns a persisted operation; poll get_sourcing_operation. Reuse the request_key only for the same request. This may consume existing Piiple credits through the normal sourcing workflow.
confirm_icp
ChatGPTStart sourcing only after the user approves the displayed ICP. Pass its exact revision from get_sourcing_state. Returns a persisted operation; poll get_sourcing_operation. Reuse the request_key only for the same request. This may consume existing Piiple credits through the normal sourcing workflow.
continue_sourcing
ChatGPTContinue a paused sourcing operation when the user requests it. Returns a persisted operation; poll get_sourcing_operation. Reuse the request_key only for the same request. This may consume existing Piiple credits through the normal sourcing workflow.
find_more_candidates
ChatGPTFind more candidates for the active completed ICP without changing its criteria. Returns a persisted operation; poll get_sourcing_operation. Reuse the request_key only for the same request. This may consume existing Piiple credits through the normal sourcing workflow.
get_sourcing_candidates
ChatGPTRead 25 candidates from the active iteration. Optional filter: all, perfect_match, strong_match, weak_match, ineligible. Filter counts cover the entire pack; filtering happens before pagination. Returns saved grouping, columns and candidate labels. Pass expected_iteration_id to avoid mixing searches.
get_sourcing_messages
ChatGPTRead an older page of this chat using the before-order and before-id cursor returned by get_sourcing_state. Preserve original message order when presenting it.
get_sourcing_operation
ChatGPTRead a previously accepted sourcing operation. Completion here means the action was submitted to the sourcing engine; inspect get_sourcing_state for pipeline progress.
get_sourcing_state
ChatGPTRead current sourcing state and follow next_action until input or completion. By default waits up to 15 seconds while processing, returning sooner on a new development or checkpoint; wait_for_change_ms=0 gives an immediate read. Relay meaningful progress_updates as intermediate text even within the same phase; progress_update is a fallback. Consider new messages before advancing after_message_order. Respect poll_after_ms. If older_messages.hasMore, use get_sourcing_messages before advancing past an unseen gap.
list_sourcing_workspaces
ChatGPTList workspace IDs and names available to the connected account, only to select where to start a sourcing conversation. With multiple workspaces, ask the user to choose; never infer the website's active workspace. No sessions or billing data are listed.
pause_sourcing
ChatGPTPause the active sourcing operation at its safe checkpoint. Returns a persisted operation; poll get_sourcing_operation. Reuse the request_key only for the same request. This may consume existing Piiple credits through the normal sourcing workflow.
refresh_sourcing
ChatGPTAdvance pending school resolution or recover a stale sourcing checkpoint using the existing website chat recovery rules. Use only when get_sourcing_state returns needs_refresh. Returns a persisted operation; poll get_sourcing_operation. Reuse the request_key only for the same request. This may consume existing Piiple credits through the normal sourcing workflow.
render_sourcing_candidates
ChatGPTShow existing candidates in Piiple's interactive card/table widget with pack-wide match filters and saved grouping, columns and labels. This is read-only and never starts a search or finds more candidates. Use session_id, optionally filter, expected active iteration and offset.
render_sourcing_icp
ChatGPTShow Piiple's ICP review form using current server data. Supply only the conversation's session_id; never provide model-authored criteria. When the form renders, accompany it with at most one short localized sentence inviting the user to edit or confirm in the form. Do not repeat criteria, empty fields, workspace name, an approval question, or technical MCP approval requirements beside the widget. If UI is unavailable, present all review groups including scopes and exclusions and request explicit approval in chat. This does not approve or start sourcing.
render_sourcing_report
ChatGPTShow Piiple's candidate pack search report after results are ready. Use only session_id; numbers, executed approaches and explanations come from the active iteration's persisted report. This read-only call never runs sourcing or finds more candidates. Returns a presentation for hosts without UI too.
retry_sourcing
ChatGPTRetry a resumable sourcing failure. Include agent_turn_id only for the retryable agent turn in the current state. Returns a persisted operation; poll get_sourcing_operation. Reuse the request_key only for the same request. This may consume existing Piiple credits through the normal sourcing workflow.
send_sourcing_message
ChatGPTAnswer a follow-up question, amend criteria, ask about this candidate pack, or answer a persisted scope/new-search decision. Piiple chooses filtering, reevaluation or search using its existing workflow. Returns a persisted operation; poll get_sourcing_operation. Reuse the request_key only for the same request. This may consume existing Piiple credits through the normal sourcing workflow.
start_sourcing
ChatGPTStart a sourcing chat from the user's hiring need. First call list_sourcing_workspaces. With multiple workspaces obtain the user's choice and pass its workspace_id; a sole workspace may be selected automatically. If workspace_selection_required is returned, ask the user and retry with the same request_key. Pass search_country_code as a two-letter country code only when the user explicitly supplies the country context; this is independent of the conversation language. If omitted, the existing TR default applies. Never infer country from locale or host IP. The workspace stays fixed for this conversation and all its follow-ups; start a new conversation to use another workspace. Piiple prepares the ICP and follow-up questions. Returns a persisted operation; poll get_sourcing_operation. Reuse the request_key only for the same request. This may consume existing Piiple credits through the normal sourcing workflow.
update_sourcing_icp
ChatGPTSave the user's edits made in the ICP form before search starts. This never approves or starts sourcing. Send only changed fields, the exact reviewed revision and a stable request_key; poll the operation then reload the ICP. Schools/companies use the same validation and resolution as the website.