Files
probo/pkg/probod/common_third_party_enrichment.go
Émile Ré 229c6b99c6 Add common third party enricher worker
Introduce a poll-based worker that fills the global common_third_parties
catalog (URLs, headquarter address, legal name, certifications, logo)
so each tenant no longer starts from sparse, name-only rows. Enrichment
is requested at row creation by ResolveOrCreateCommonThirdParty; curated
seed rows are not enqueued, to avoid a re-seed storm.

The pipeline uses two specialized agents plus a deterministic logo step.
Agent A (company profile) resolves legal name, headquarter address, and
the canonical website over web search; its website and legal name feed
Agent B and the logo step. Agent B (compliance docs) resolves the legal
document URLs, trust/security/status pages, and certifications using the
browser read-only toolset (gated on ChromeDPAddr) plus web search. The
logo step restores pkg/webinspect as a pure deterministic package and
stores the discovered icon in S3, linked via logo_file_id.

Each agent returns per-field value/confidence/source_url. The worker
writes a column only when confidence clears a configurable threshold and
the field is not externally owned (seed or human), and always records
full per-field provenance in a new enrichment JSONB column so re-runs
fill only gaps and human edits are never clobbered. New bookkeeping
columns (enrichment_requested_at, enrichment, enrichment_attempts) back
the claim queue and stale recovery; agents run outside transactions and
results persist in one final transaction.

The worker is opt-in: it no-ops unless its agent provider is configured.

Signed-off-by: Émile Ré <emile@probo.com>
2026-06-12 14:39:51 +02:00

74 lines
2.7 KiB
Go

// Copyright (c) 2026 Probo Inc <hello@getprobo.com>.
//
// Permission to use, copy, modify, and/or distribute this software for any
// purpose with or without fee is hereby granted, provided that the above
// copyright notice and this permission notice appear in all copies.
//
// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
// REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
// AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
// INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
// LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
// OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
// PERFORMANCE OF THIS SOFTWARE.
package probod
import (
"fmt"
"time"
"github.com/prometheus/client_golang/prometheus"
"go.gearno.de/kit/log"
"go.opentelemetry.io/otel/trace"
"go.probo.inc/probo/pkg/filemanager"
"go.probo.inc/probo/pkg/thirdparty"
)
// buildCommonThirdPartyEnrichmentConfig wires the common-third-party
// enrichment worker config: the LLM client for its two agents plus the
// worker tuning, browser endpoint, and logo-storage dependencies. It is
// opt-in: a deployment that does not set
// `llm.common-third-party-enrichment.provider` gets a zero config (nil
// LLM client), so the worker runs as a no-op and the caller skips
// registration.
func (impl *Implm) buildCommonThirdPartyEnrichmentConfig(
l *log.Logger,
tp trace.TracerProvider,
r prometheus.Registerer,
fileManager *filemanager.Service,
) (thirdparty.EnrichmentConfig, error) {
if impl.cfg.Agents.CommonThirdPartyEnrichment.Provider == "" {
return thirdparty.EnrichmentConfig{}, nil
}
agentCfg, llmClient, err := impl.resolveAgentClient(
"common-third-party-enrichment",
impl.cfg.Agents.CommonThirdPartyEnrichment,
l,
tp,
r,
)
if err != nil {
return thirdparty.EnrichmentConfig{}, fmt.Errorf("cannot resolve common third party enrichment agent client: %w", err)
}
workerCfg := impl.cfg.CommonThirdPartyEnrichmentWorker
return thirdparty.EnrichmentConfig{
LLMClient: llmClient,
Model: agentCfg.ModelName,
MaxTokens: agentCfg.MaxTokens,
Temperature: agentCfg.Temperature,
FirecrawlAPIKey: impl.cfg.Agents.Tools.FirecrawlAPIKey,
ChromeAddr: impl.cfg.ChromeDPAddr,
AgentTimeout: time.Duration(workerCfg.AgentTimeout) * time.Second,
MaxTurns: workerCfg.AgentMaxTurns,
ConfidenceThreshold: workerCfg.ConfidenceThreshold,
StaleAfter: time.Duration(workerCfg.StaleAfter) * time.Second,
MaxAttempts: workerCfg.MaxAttempts,
FileManager: fileManager,
Bucket: impl.cfg.AWS.Bucket,
}, nil
}