Integrazioni

Comandi disponibili

• ✓ Detect PII in File -- scansiona e evidenzia il file attivo
• ✓ Anonymize Selection -- sostituisce il testo selezionato con i token
• ✓ Anonymize Entire File -- anonimizza tutto il contenuto del file
• ✓ Clear Highlights -- rimuove le evidenziature PII dal file
• ✓ Login OAuth -- nessuna API key da copiare o salvare nei file
• ✓ Un solo menu workspace -- account, team, tipo documento e modalità
• ✓ @pseudora Protected Chat -- anonimizza prima di invocare il modello
• ✓ Risposta streaming protetta o ripristinata, configurabile per workspace
• ✓ Pausa temporanea -- disabilita comandi editor, scansione automatica e MCP
• ✓ MCP separato -- spegni gli strumenti agentici lasciando attivo l'editor
• ✓ MCP integrato -- protegge i dati elaborati dentro i workflow Agent

Configurazione automatica

Strumenti esposti

• ✓ anonymize_text -- anonimizza e restituisce il context_id
• ✓ deanonymize_text -- ripristina gli originali dal context_id
• ✓ list_pii_types -- elenca le entità rilevabili
• ✓ list_document_types -- elenca le policy disponibili per il team
• ✓ Quote, ACL e configurazioni restano gestite da Pseudora Cloud

Configurazione MCP remota

{
  "mcpServers": {
    "pseudora": {
      "url": "https://mcp.pseudora.cloud/mcp",
      "headers": {
        "Authorization": "Bearer pii_cust_..."
      }
    }
  }
}

Installazione

pip install pseudora

Utilizzo

from pseudora import Pseudora

client = Pseudora("pii_cust_...")

result = client.anonymize(
    "Mario Rossi, CF RSSMRA80A01H501U",
    context_type="generic",
)
# [PERSON_1], CF [FISCAL_CODE_1]
print(result.text)

# Ripristino originali
original = client.deanonymize(
    result.context_id, result.text
)

Caratteristiche

• ✓ anonymize() e deanonymize() sincroni e async
• ✓ Context type e lingua configurabili per chiamata
• ✓ Fail-closed: errore esplicito se il motore non risponde
• ✓ Compatibile con Django, FastAPI e script standalone
• ✓ Supporta Python 3.9+

Installazione

npm install @pseudora/sdk

Utilizzo (TypeScript)

import { Pseudora } from '@pseudora/sdk';

const client = new Pseudora({
  apiKey: 'pii_cust_...',
});

const result = await client.anonymize(
  'Mario Rossi, CF RSSMRA80A01H501U',
  { contextType: 'generic' },
);
// [PERSON_1], CF [FISCAL_CODE_1]
console.log(result.text);

const original = await client.deanonymize(
  result.contextId, result.text
);

Caratteristiche

• ✓ anonymize() e deanonymize() che restituiscono Promise
• ✓ Tipi TypeScript inclusi nel pacchetto
• ✓ Middleware Express e Fastify per sanitizzare request e response
• ✓ Context type e lingua configurabili per chiamata
• ✓ Fail-closed: errore esplicito se il motore non risponde

Python

from openai import OpenAI

client = OpenAI(
  base_url="https://gateway.pseudora.cloud/v1",
  api_key="pii_cust_...",
)

# Il resto del codice rimane invariato
response = client.chat.completions.create(
  model="gpt-4o",
  messages=[{"role": "user",
             "content": "Riassumi: Mario Rossi..."}],
)

TypeScript

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://gateway.pseudora.cloud/v1',
  apiKey: 'pii_cust_...',
});

// Il resto del codice rimane invariato
const response = await client.chat.completions.create({
  model: 'gpt-4o',
  messages: [{ role: 'user',
               content: 'Riassumi: Mario Rossi...' }],
});

Caratteristiche

• ✓ Drop-in: cambia solo base_url nel client OpenAI gia' in uso
• ✓ Anonimizzazione pre-invio su Chat Completions e Responses API
• ✓ Ripristino opzionale nella risposta (header X-Restore: true)
• ✓ Streaming e non-streaming supportati
• ✓ Compatibile anche con Anthropic Messages API (endpoint separato)