Knowledge Quality¶
Cluster: Uncategorised | Type: component | MCP Tools: 9
Overview¶
Public API¶
KnowledgeQualityDecisionError(ValueError)¶
The grounded runtime could not produce a usable knowledge_quality decision.
CoverageGapDecision¶
| Field | Type | Default |
|---|---|---|
gap_detected | bool | True |
rationale | str | '' |
signals | list[str] | field(default_factory=list) |
confidence | float | 0.0 |
completion_state | str | 'qualified-draft' |
degraded | bool | False |
raw_response | str | '' |
AuthorityScoreDecision¶
| Field | Type | Default |
|---|---|---|
score | float | 0.0 |
rationale | str | '' |
signals | list[str] | field(default_factory=list) |
confidence | float | 0.0 |
completion_state | str | 'qualified-draft' |
degraded | bool | False |
raw_response | str | '' |
KnowledgeQualityRuntime(Protocol)¶
The grounded decision surface knowledge_quality gained.
Methods:
detect_coverage_gap(results: list[dict], top_k: int) -> CoverageGapDecision¶
score_source_authority(url: str, citation_count: int, peer_reviewed: bool, venue: str) -> AuthorityScoreDecision¶
LLMKnowledgeQualityRuntime¶
Provider-neutral knowledge_quality runtime backed by G6's LLM caller.
Constructor:
| Parameter | Type | Default |
|---|---|---|
llm | LLMCaller \| None | None |
Methods:
detect_coverage_gap(results: list[dict], top_k: int) -> CoverageGapDecision¶
score_source_authority(url: str, citation_count: int, peer_reviewed: bool, venue: str) -> AuthorityScoreDecision¶
KnowledgeQualityPlanner¶
Runtime-first facade with real deterministic fallbacks and one-way floors.
Constructor:
| Parameter | Type | Default |
|---|---|---|
runtime | KnowledgeQualityRuntime \| None | None |
Methods:
detect_coverage_gap(results: list[dict], top_k: int) -> CoverageGapDecision¶
score_source_authority(url: str, citation_count: int = 0, peer_reviewed: bool = False, venue: str = '') -> AuthorityScoreDecision¶
AuthorityExplanation¶
Additive breakdown of an authority score.
| Field | Type | Default |
|---|---|---|
source_rule | str | required |
base | float | required |
citation_bonus | float | required |
peer_review_bonus | float | required |
venue_bonus | float | required |
CoverageReport¶
| Field | Type | Default |
|---|---|---|
gap_detected | bool | required |
gap_message | str | required |
avg_score | float | required |
avg_authority | float | required |
avg_confidence | float | required |
corpus_density_score | float | required |
KnowledgeQualityInput(BaseModel)¶
Input to KnowledgeQualityBlock.
| Field | Type | Default |
|---|---|---|
decision | Literal['coverage_gap_detection', 'source_authority_scoring'] | required |
results | list[dict[str, Any]] | Field(default_factory=list) |
top_k | int | 5 |
url | str | '' |
citation_count | int | 0 |
peer_reviewed | bool | False |
venue | str | '' |
KnowledgeQualityOutput(BaseModel)¶
Output from KnowledgeQualityBlock.
| Field | Type | Default |
|---|---|---|
decision | str | required |
gap_detected | bool \| None | None |
authority_score | float \| None | None |
rationale | str | '' |
degraded | bool | False |
agentic_evidence | dict[str, Any] \| None | None |
KnowledgeQualityBlock(AIBlock[KnowledgeQualityInput, KnowledgeQualityOutput, dict])¶
Live-wired advisory knowledge-quality assessor.
| Field | Type | Default |
|---|---|---|
name | str | 'knowledge_quality' |
resource_bounds | ResourceBounds \| None | None |
usage | ResourceUsage | field(default_factory=ResourceUsage) |
Methods:
infer(data: KnowledgeQualityInput) -> Result[KnowledgeQualityOutput]¶
CitationResult(dict)¶
Typed-failure-discriminating result of a Semantic Scholar fetch.
Constructor:
| Parameter | Type | Default |
|---|---|---|
status | CitationStatus | required |
metadata | Optional[dict] | required |
retryable | bool | required |
source_available | bool | required |
Functions¶
agentic_planner_enabled(default_enabled: bool) -> bool¶
Decide whether the agentic knowledge_quality planner should be used.
venue_prestige_bonus(venue: str) -> float¶
score_authority(url: str, citation_count: int = ..., peer_reviewed: bool = ..., venue: str = ..., explain: bool = ...) -> Union[float, tuple[float, 'AuthorityExplanation']]¶
score_authority(url: str, citation_count: int = 0, peer_reviewed: bool = False, venue: str = '', explain: bool = False) -> Union[float, tuple[float, 'AuthorityExplanation']]¶
Compute authority score 0.0–1.0.
analyze_coverage(results: list[dict], top_k: int = 5) -> CoverageReport¶
results: list of dicts with keys: score, optionally authority_score, confidence.
fetch_arxiv_citation_count(arxiv_id: str) -> CitationResult¶
Returns paper quality metadata for an arXiv ID or URL.
fetch_doi_citation_count(doi: str) -> CitationResult¶
Same schema as fetch_arxiv_citation_count, keyed by DOI.
MCP Tools¶
| Operation | Source |
|---|---|
ops | knowledge_quality_mcp |
help | knowledge_quality_mcp |
score_authority | knowledge_quality_mcp |
analyze_coverage | knowledge_quality_mcp |
detect_coverage_gap | knowledge_quality_mcp |
venue_prestige | knowledge_quality_mcp |
list_strategies | knowledge_quality_mcp |
explain_authority | knowledge_quality_mcp |
list_patterns | knowledge_quality_mcp |