Loading
Concessione sovvenzioni
Creazione di una libreria di documenti per l'agente dell'assistenza richiedente e sovvenzionato

Creazione di una libreria di documenti per l'agente dell'assistenza richiedente e sovvenzionato

Caricare i file PDF in una libreria di dati Agentforce per consentire al richiedente e all'agente dell'assistenza sovvenzionato di recuperare le risposte dai documenti della sovvenzione.

Versioni (Edition) richieste

Disponibile nelle versioni: Lightning Experience
Disponibile in: Nonprofit Cloud per Concessione sovvenzioni e Soluzioni per il settore pubblico. Visualizzare la disponibilità.
Autorizzazioni utente richieste
Per creare una libreria di dati Agentforce: Autorizzazione di sistema Gestisci librerie di dati
Per modificare un agente nel Generatore di agenti: Autorizzazione di sistema Gestisci bot

Completare l'impostazione dell'agente dell'assistenza prima di creare una libreria di documenti.

  1. Creare la libreria di dati Agentforce.
    Se l'organizzazione supporta più programmi di sovvenzioni, ripetere questa operazione per ciascuno di essi. Vedere l'esempio per informazioni dettagliate sulla configurazione dell'agente per più retriever.
    1. Da Imposta, immettere Agentforce Data Library nella casella Ricerca veloce, quindi selezionare Agentforce Data Library.
    2. Fare clic su Aggiungi dati. È possibile caricare file locali o utilizzare un retriever personalizzato.
    3. Selezionare uno spazio dati e assegnare un nome alla libreria di dati.
    4. Caricare i file PDF e fare clic su Salva.
      Importante
      Importante Per risultati ottimali, caricare PDF con contenuti chiari e ben strutturati. Evitare documenti governativi complessi e formattati, come gli avvisi di opportunità di finanziamento (NOFO), che sono difficili da elaborare per l'agente a causa della loro lunghezza e formattazione. Un documento in stile Domande frequenti che affronta direttamente le domande comuni dei richiedenti sovvenzioni è l'ideale.
  2. Attendere che la libreria di dati raggiunga lo stato Pronta.

    Dopo il caricamento dei file, Salesforce li indicizza automaticamente e crea le configurazioni Data Cloud sottostanti. Questo processo richiede circa 15-20 minuti. Per controllare l'avanzamento, accedere a Programma di avvio app | Data Cloud | Indici di ricerca e attendere che venga creato l'indice di ricerca e che la libreria di dati venga visualizzata come Pronta.

    Importante
    Importante Non collegare la libreria all'agente finché non viene visualizzato lo stato Pronto. L'uso di una libreria prima del completamento dell'indicizzazione produce risultati incompleti o mancanti.
  3. Assegnare tag agli oggetti modello di dati della libreria di documenti per l'accesso degli utenti esterni.

    Quando indicizza la libreria di documenti, Salesforce crea tre oggetti modello di dati (DMO) in Data Cloud. È necessario assegnare tag a questi DMO in modo che gli utenti esterni della comunità possano accedere al retriever. Gli utenti interni della piattaforma sono coperti automaticamente dalla policy predefinita per il set di regole All Data Access di Salesforce e non richiedono questo passaggio.

    1. Dal Programma di avvio app, aprire Data Cloud e fare clic su Modello di dati.
    2. Individuare i tre DMO creati per la libreria di documenti. I nomi seguono questi schemi, dove LibraryName è il primo 15 caratteri del nome API della libreria.
      • ADL_LibraryName
      • ADL_LibraryName chunk
      • ADL_LibraryName index
    3. Per ogni DMO, aprire la relativa pagina dei dettagli facendo clic sull'etichetta dell'oggetto, quindi su Gestisci tag e quindi su Allega tag.
    4. Nella casella di ricerca, cercare e aggiungere i seguenti tag.
      • ExternalData.Visibility.Portal
      • ExternalData.Visibility.Public
    5. Selezionare Aggiungi questi tag a [nome libreria] e fare clic su Salva.
    6. Nella pagina Dettagli DMO, fare clic su Fatto.
    7. Ripetere i passaggi secondari da (c) a (f) per ciascuno dei DMO rimanenti.
  4. Ottenere il nome API del retriever della libreria.
    1. Da Imposta, immettere Agentforce Data Library nella casella Ricerca veloce, quindi selezionare Agentforce Data Library.
    2. Selezionare la libreria di dati.
    3. Nella sezione Stato, fare clic sul link Recupero.
    4. In Dettagli recupero, copiare il Nome API.
      Il nome API retriever segue il File_ADL_LibraryName_UniqueID dello schema, ad esempio File_ADL_GrantDocuments_1Cx_l2D32f7b02d.
  5. Aggiornare l'agente in modo che utilizzi il Recuperatore libreria documenti.
    1. Dal Programma di avvio app, immettere Agenti nella casella di ricerca, quindi selezionare Agenteforce Studio e aprire l'agente dell'assistenza richiedente e sovvenzionato.
    2. Se l'agente è attivo, fare clic su Disattiva.
    3. Passare dalla visualizzazione Area di disegno alla visualizzazione Script.
    4. Nel sottoagente Assistenza Grantseeker (1), trovare l'azione AnswersQuestionsFromDocument (2) e aggiornare le relative istruzioni in modo che facciano riferimento al nome API retriever (3) copiato nel passaggio precedente.Generatore di agenti dell'assistenza Grantseeker.
    5. Fare clic su Salva, quindi passare dalla visualizzazione Script alla visualizzazione Area di disegno.
    6. Nel riquadro Explorer, in Dati, selezionare Libreria di dati.
    7. Cercare e selezionare la libreria di dati.
    8. Fare clic su Salva e quindi su Impegna versione.
  6. Testare la libreria di documenti.
    1. Nel Generatore di agenti, fare clic su Anteprima.
    2. Porre una domanda a cui si può rispondere dai documenti caricati e verificare che l'agente restituisca una risposta pertinente.
Esempio
Esempio Esempio: Configurazione dello script agente per più programmi di sovvenzioni

Se l'organizzazione supporta più programmi di sovvenzioni, aggiornare le istruzioni per il subagente Assistenza Grantseeker nella visualizzazione Script per indirizzare l'agente al retriever corretto in base alla domanda dell'utente. L'esempio seguente mostra le istruzioni configurate per due programmi di sovvenzioni. Sostituire gli ID retriever e i nomi delle sovvenzioni con i propri.

subagent GrantseekerAssistance:
    label: "Grantseeker Assistance"
    description: "Answer grantseeker questions about grant programs, eligibility, application procedures, deadlines, and funding guidelines using document search and knowledge base."
    reasoning:
        instructions: ->
            | Your organization supports TWO grant programs. Use only the retriever for the grant the user is asking about:
              - Digital Equity Competitive Grant: File_Digital_Equity_Competitive_Grant_1Cx_ZZ3deff5335
              - Public Wireless Supply Chain Innovation Fund Grant: File_Public_Wireless_Supply_Chain_Innova_1Cx_ZZ393667fb8

              1. Identify which grant the user is asking about before taking any action.
                 - If the grant was named earlier in the conversation, continue using it for follow-up questions unless the user clearly switches.
                 - If the grant hasn't been identified, ask the user which grant their question is about. Do not call any action until a grant is identified.
                 - Recognize common shorthand (for example, "digital equity" for the Digital Equity Competitive Grant; "public wireless," "supply chain," or "wireless innovation" for the Public Wireless Supply Chain Innovation Fund Grant). When in doubt, ask.
                 - If the user names an unsupported grant, do not search. Tell them the two supported programs and direct them to the grants administrator for any other program.
                 - If the user asks a question that compares or spans both grants, decline politely and direct them to the grants administrator.
              2. Use the Answer Questions from Document action to search the identified grant's document retriever. Do not include the grant name in the search query — the retriever is already scoped to that grant.
              3. If the document search doesn't provide a sufficient answer, use the Answer Questions with Knowledge action to search Salesforce Knowledge articles.
              4. If neither action provides relevant information, clearly state that you couldn't find an answer and direct the user to contact the grants administrator or support team for further assistance.
              - Always provide clear, accurate, and concise answers based only on information retrieved from documents or knowledge articles.
              - Never fabricate facts, instructions, dates, requirements, or data values that aren't explicitly stated in your provided resources.
              - Never use content from one grant's retriever in an answer about the other grant.
              - When relevant, mention eligibility conditions, required documents, and next steps.
              - Confirm with the user whether the answer resolved their question.

Per concedere all'agente l'accesso agli articoli Knowledge oltre ai documenti, vedere Creazione di una libreria di articoli Knowledge per l'agente dell'assistenza richiedente e sovvenzionato. In caso contrario, procedere all'attivazione dell'agente Grantseeker.

 
Caricamento
Salesforce Help | Article