battuta - Amazon Kendra

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

battuta

Quip è un software di produttività collaborativa che offre funzionalità di creazione di documenti in tempo reale. Puoi usarlo Amazon Kendra per indicizzare le cartelle, i file, i commenti sui file, le chat room e gli allegati di Quip.

Puoi connetterti Amazon Kendra alla tua fonte di dati Quip usando la Amazon Kendra console e l'API. QuipConfiguration

Per la risoluzione dei problemi del connettore di origine dati Amazon Kendra Quip, consulta. Risoluzione dei problemi relativi alle origini dati

Funzionalità supportate

Amazon Kendra Il connettore di origine dati Quip supporta le seguenti funzionalità:

  • Mappature dei campi

  • Controllo dell'accesso degli utenti

  • Filtri di inclusione/esclusione

  • Virtual Private Cloud (VPC) (Cloud privato virtuale (VPC)

Prerequisiti

Prima di poterla utilizzare Amazon Kendra per indicizzare la tua fonte di dati Quip, apporta queste modifiche a Quip e agli account. AWS

In Quip, assicurati di avere:

  • Un account Quip con autorizzazioni amministrative.

  • Credenziali di autenticazione Quip create che includono un token di accesso personale. Il token viene utilizzato come credenziale di autenticazione memorizzata in un segreto. AWS Secrets Manager Per ulteriori informazioni, consulta la documentazione di Quip sull'autenticazione.

    Nota

    Ti consigliamo di aggiornare o ruotare regolarmente le credenziali e il segreto. Fornisci solo il livello di accesso necessario per la tua sicurezza. Non è consigliabile riutilizzare credenziali e segreti tra diverse fonti di dati e versioni dei connettori 1.0 e 2.0 (ove applicabile).

  • Hai copiato il dominio del tuo sito Quip. Ad esempio, https://quip-company.quipdomain.com/browse quipdomain dov'è il dominio.

  • È stato verificato che ogni documento sia unico in Quip e tra le altre fonti di dati che intendi utilizzare per lo stesso indice. Ogni fonte di dati che desideri utilizzare per un indice non deve contenere lo stesso documento in tutte le fonti di dati. IDs I documenti sono globali rispetto a un indice e devono essere univoci per indice.

Nel tuo Account AWS, assicurati di avere:

  • Ha creato un Amazon Kendra indice e, se si utilizza l'API, ha annotato l'ID dell'indice.

  • Hai creato un IAM ruolo per la tua origine dati e, se utilizzi l'API, hai annotato l'ARN del IAM ruolo.

    Nota

    Se modifichi il tipo di autenticazione e le credenziali, devi aggiornare il IAM ruolo per accedere all'ID AWS Secrets Manager segreto corretto.

  • Ha archiviato le credenziali di autenticazione Quip in un AWS Secrets Manager luogo segreto e, se si utilizza l'API, ha annotato l'ARN del segreto.

    Nota

    Ti consigliamo di aggiornare o ruotare regolarmente le credenziali e il segreto. Fornisci solo il livello di accesso necessario per la tua sicurezza. Non è consigliabile riutilizzare credenziali e segreti tra diverse fonti di dati e versioni dei connettori 1.0 e 2.0 (ove applicabile).

Se non disponi di un IAM ruolo o di un segreto esistente, puoi utilizzare la console per creare un nuovo IAM ruolo e un Secrets Manager segreto quando connetti la tua fonte di dati Quip a. Amazon Kendra Se utilizzi l'API, devi fornire l'ARN di un IAM ruolo e di un Secrets Manager segreto esistenti e un ID di indice.

Istruzioni di connessione

Per connetterti Amazon Kendra alla tua fonte dati Quip, devi fornire i dettagli necessari della tua fonte di dati Quip in modo che Amazon Kendra possa accedere ai tuoi dati. Se non hai ancora configurato Quip per Amazon Kendra, vedi. Prerequisiti

Console

Per connettersi Amazon Kendra a Quip

  1. Accedi a AWS Management Console e apri la Amazon Kendra console.

  2. Dal riquadro di navigazione a sinistra, scegli Indici, quindi scegli l'indice che desideri utilizzare dall'elenco degli indici.

    Nota

    Puoi scegliere di configurare o modificare le impostazioni del controllo dell'accesso degli utenti in Impostazioni dell'indice.

  3. Nella pagina Guida introduttiva, scegli Aggiungi origine dati.

  4. Nella pagina Aggiungi origine dati, scegli Connettore Quip, quindi scegli Aggiungi connettore. Se utilizzi la versione 2 (se applicabile), scegli il connettore Quip con il tag «V2.0".

  5. Nella pagina Specificare i dettagli dell'origine dati, inserisci le seguenti informazioni:

    1. In Nome e descrizione, per Nome dell'origine dati, inserisci un nome per l'origine dati. Puoi includere trattini ma non spazi.

    2. (Facoltativo) Descrizione: immetti una descrizione facoltativa per l'origine dati.

    3. In Lingua predefinita: scegli una lingua per filtrare i documenti per l'indice. Se non diversamente specificato, la lingua predefinita è l'inglese. La lingua specificata nei metadati del documento ha la precedenza sulla lingua selezionata.

    4. In Tag, per Aggiungi nuovo tag, includi tag opzionali per cercare e filtrare le risorse o tenere traccia dei costi. AWS

    5. Scegli Next (Successivo).

  6. Nella pagina Definisci accesso e sicurezza, inserisci le seguenti informazioni:

    1. Nome di dominio Quip: inserisci il Quip che hai copiato dal tuo account Quip.

    2. AWS Secrets Manager segreto: scegli un segreto esistente o creane uno nuovo per memorizzare le tue credenziali di autenticazione Secrets Manager Quip. Se scegli di creare un nuovo segreto, si apre una finestra AWS Secrets Manager segreta.

      1. Inserisci le seguenti informazioni nella finestra Crea un AWS Secrets Manager segreto:

        1. Nome segreto: un nome per il tuo segreto. Il prefisso 'AmazonKendra-Quip-' viene aggiunto automaticamente al tuo nome segreto.

        2. Token Quip: inserisci il Quip configurato per l'accesso personale di Quip.

      2. Aggiungi e salva il tuo segreto.

    3. Virtual Private Cloud (VPC): puoi scegliere di utilizzare un VPC. In tal caso, è necessario aggiungere sottoreti e gruppi di sicurezza VPC.

    4. IAM ruolo: scegli un IAM ruolo esistente o creane uno nuovo IAM per accedere alle credenziali del repository e indicizzare il contenuto.

      Nota

      IAM i ruoli utilizzati per gli indici non possono essere utilizzati per le fonti di dati. Se non sei sicuro che un ruolo esistente venga utilizzato per un indice o una FAQ, scegli Crea un nuovo ruolo per evitare errori.

    5. Scegli Next (Successivo).

  7. Nella pagina Configura le impostazioni di sincronizzazione, inserisci le seguenti informazioni:

    1. Aggiungi la cartella Quip IDs da scansionare: la cartella Quip che IDs vuoi scansionare.

      Nota

      Per eseguire la scansione di una cartella principale, incluse tutte le sottocartelle e i documenti al suo interno, aggiungi l'ID della cartella principale. Per eseguire la scansione di sottocartelle specifiche, aggiungi la sottocartella specifica. IDs

    2. Configurazione aggiuntiva (tipi di contenuto): inserisci i tipi di contenuto che desideri sottoporre a scansione.

    3. Modelli Regex: modelli di espressioni regolari per includere o escludere determinati file. È possibile aggiungere fino a 100 pattern.

    4. In Sync run schedulation, per Frequenza: scegli la frequenza con cui sincronizzare il contenuto della fonte di dati e aggiornare l'indice

    5. Scegli Next (Successivo).

  8. Nella pagina Imposta mappature dei campi, inserisci le seguenti informazioni:

    1. Seleziona uno dei campi di origine dati predefiniti generati che desideri mappare per indicizzare Amazon Kendra .

    2. Aggiungi campo: consente di aggiungere campi di origine dati personalizzati per creare un nome di campo indice a cui mappare e il tipo di dati del campo.

    3. Scegli Next (Successivo).

  9. Nella pagina Rivedi e crea, verifica che le informazioni inserite siano corrette, quindi seleziona Aggiungi origine dati. Puoi anche scegliere di modificare le tue informazioni da questa pagina. L'origine dati verrà visualizzata nella pagina Origini dati dopo che l'origine dati sarà stata aggiunta correttamente.

API

Per connettersi Amazon Kendra a Quip

È necessario specificare quanto segue utilizzando l'QuipConfiguration API:

  • Dominio del sito Quip: ad esempio, https://quip-company.quipdomain.com/browse quipdomain dov'è il dominio.

  • Secret Amazon Resource Name (ARN): fornisci l'Amazon Resource Name (ARN) di un Secrets Manager segreto che contiene le credenziali di autenticazione per il tuo account Quip. Il segreto è archiviato in una struttura JSON con le seguenti chiavi:

    { "accessToken": "token" }
  • IAM ruolo: specifica RoleArn quando chiami CreateDataSource per fornire a un IAM ruolo le autorizzazioni per accedere al tuo Secrets Manager segreto e per chiamare il pubblico richiesto APIs per il connettore Quip e. Amazon Kendra Per ulteriori informazioni, consulta IAM i ruoli per le fonti di dati Quip.

Puoi anche aggiungere le seguenti funzionalità opzionali:

  • Virtual Private Cloud (VPC): specifica VpcConfiguration come parte della configurazione dell'origine dati. Vedi Configurazione Amazon Kendra per l'uso di un VPC.

  • Filtri di inclusione ed esclusione: specifica se includere o escludere determinati file.

    Nota

    La maggior parte delle fonti di dati utilizza modelli di espressioni regolari, che sono modelli di inclusione o esclusione denominati filtri. Se si specifica un filtro di inclusione, viene indicizzato solo il contenuto che corrisponde al filtro di inclusione. Qualsiasi documento che non corrisponde al filtro di inclusione non viene indicizzato. Se si specifica un filtro di inclusione ed esclusione, i documenti che corrispondono al filtro di esclusione non vengono indicizzati, anche se corrispondono al filtro di inclusione.

  • Cartelle: specifica le cartelle e le sottocartelle Quip che desideri indicizzare

    Nota

    Per eseguire la scansione di una cartella principale, incluse tutte le sottocartelle e i documenti al suo interno, inserisci l'ID della cartella principale. Per eseguire la scansione di sottocartelle specifiche, aggiungi la sottocartella specifica. IDs

  • Allegati, chat room, commenti ai file: scegli se includere la scansione degli allegati, il contenuto delle chat room e i commenti sui file.

  • Filtro del contesto utente e controllo degli accessi:Amazon Kendra esegue la ricerca per indicizzazione dell'elenco di controllo degli accessi (ACL) dei documenti, se disponi di un ACL per i documenti. Le informazioni ACL vengono utilizzate per filtrare i risultati della ricerca in base all'accesso dell'utente o del relativo gruppo ai documenti. Per ulteriori informazioni, consulta Filtraggio del contesto utente.

  • Mappature dei campi: scegli di mappare i campi della sorgente dati di Quip ai campi indice. Amazon Kendra Per ulteriori informazioni, consulta la sezione Mappatura dei campi di origine dei dati.

    Nota

    Il campo del corpo del documento o l'equivalente del corpo del documento per i documenti è necessario per poter Amazon Kendra eseguire la ricerca nei documenti. È necessario mappare il nome del campo del corpo del documento nella fonte dati al nome del campo indice_document_body. Tutti gli altri campi sono facoltativi.

Ulteriori informazioni

Per saperne di più sull'integrazione Amazon Kendra con la tua fonte di dati Quip, vedi: