MCP Tool
nova.pks_upsert
For knowledge signals, learning candidates, and explainable orientation, an agent uses this public tool to carry out the bounded step "Source Opportunity Auto-Resolve". It separates target confirmation, intended state change, and verification after execution.
Canonical reference for a public MCP tool name.
- Type
- MCP tool
- Family
- Learning & Knowledge Evolution
- Effect
- changes state
- Status
- Explained
- Path
- 11.19
Purpose
What this entry explains
What it does
nova.pks_upsert
An agent uses this tool to carry out the bounded step "Source Opportunity Auto-Resolve". It belongs to knowledge signals, learning candidates, and explainable orientation; agents should combine it with current discovery, target awareness, and the visible result.
Use when
- Use this entry when an agent needs to carry out the bounded step "Source Opportunity Auto-Resolve" for knowledge signals, learning candidates, and explainable orientation.
- Use it to understand the public tool name, its expected boundary, and the response signals to check.
- Use it before chaining follow-up tools so the next step is based on current evidence.
Reference Use
How agents should cite and apply this area
Examples are maintained at family level and use only public tool names or reference paths already present in the catalog.
Family example
A task touches data, identity, or permissions in knowledge signals, learning candidates, and explainable orientation that may be used only with clear purpose.
The agent starts with nova.learn_suggest, reads the current response or reference, and only then chooses the concrete next tool.
Sensitive values stay in current scope; they are not guessed, logged, or copied into other contexts.Contract
Inputs and important response fields
This page is a public reference. Agents and integrators should still read current MCP tool discovery before execution, because schemas can be gated by settings or version.
Inputs
No stable public input field is derived from the catalog source for this path. Read current MCP discovery before execution.
| Response field | Explanation |
|---|---|
sourceOpportunityId | Identifier or reference value. Do not guess it from memory; read it from the current response. |
Safety
Boundary before execution
Can change browser, page, or workflow state. The target and expected result must be clear before execution.
Treat stored knowledge as guidance only. Before any action, confirm the current page, target, scope, and visible evidence again.
For humans, this entry names the browser or workflow state in knowledge signals, learning candidates, and explainable orientation that may change, so the action can be reviewed before and after execution.
Safety Axes
How this path can affect work
Axes are stable catalog signals for humans, agents, and LLM discovery. One path can carry several axes.
browser_state_change
Changes tab, navigation, focus, claim, scroll position, window state, or browser environment.
Confirm the target context visibly before execution and verify that the expected browser state was reached afterwards.page_interaction
Clicks, types, selects, uploads, or interacts with visible page elements.
Execute only with a visible target, expected effect, and a follow-up result check.persistent_change
Saves, deletes, remembers, schedules, or changes data that may outlive the immediate page state.
Execute only with clear scope and keep the saved, deleted, or scheduled effect reviewable.user_confirmation
Requires visible confirmation, target review, approval, or deliberate user control.
Do not proceed until the required confirmation is visible or unambiguous in the current context.