GetRAGSpaceInfo
Retourneert informatie over de opgegeven RAG-ruimte of alle RAG-ruimten, als er geen ruimte-ID is opgegeven.
Opmaak
GetRAGSpaceInfo ( ragAccountName {; spaceID } )
Parameters
RagAccountName
- een tekstexpressie voor de naam van het RAG-account dat u wilt gebruiken. Gebruik in het huidige bestand de RAG-account configureren scriptstap om het account in te stellen en deze naam toe te wijzen op elk moment voordat deze functie wordt uitgevoerd.
spaceID
- ID van een RAG-ruimte. Als deze optie wordt weggelaten, wordt informatie geretourneerd over alle RAG-ruimten voor het opgegeven account.
Parameters tussen accolades { } zijn optioneel.
Resulterend gegevenstype
tekst
Afkomstig uit versie
22.0
Beschrijving
GetRAGSpaceInfo retourneert informatie over retrieval-augmented generation-ruimten (RAG) op de AI-modelserver gespecificeerd door ragAccountName
. U kunt deze gebruiken om het bestaan van een RAG-ruimte te controleren, de inhoud ervan te bewaken en RAG-activiteiten te controleren.
Als er geen spaceID
-waarde is opgegeven, retourneert de functie een JSON-object met een matrix van RAG-ruimten die beschikbaar zijn voor het opgegeven RAG-account:
{
"rag_space_list": [
{
"space_id": "<string>",
"model": "<string>"
}
]
}
-
rag_space_list
is een matrix van RAG-ruimten. -
space_id
is de sleutel voor een RAG-ruimte-ID. -
model
is de sleutel voor de naam van het model dat wordt gebruikt om vectoren voor het insluiten van tekst in deze RAG-ruimte te genereren.
Als er een spaceID
-waarde is opgegeven, retourneert de functie een JSON-object met informatie over de RAG-ruimte en de gegevens daarin:
{
"rag_space_id": "<string>",
"model": "<string>",
"entries": <number>,
"values": [
{
"id": <number>,
"filename": "<string>"
},
{
"id": <number>,
"text": "<string>"
}
]
}
-
rag_space_id
is de ID van de RAG-ruimte. -
model
is de naam van het model dat wordt gebruikt voor het genereren van vectoren voor het insluiten van tekst in deze RAG-ruimte. -
entries
is het aantal elementen in de matrixvalues
. -
values
is een matrix van delen van tekstdocumenten en PDF-bestandsnamen:-
id
is een numerieke ID voor het tekstdocument waaruit een tekstblok afkomstig is, of voor een PDF-bestand. -
filename
is de naam van een PDF-bestand dat aan de ruimte wordt toegevoegd. -
text
is een deel van een tekstdocument dat aan de ruimte wordt toegevoegd. Delen uit hetzelfde tekstdocument hebben dezelfdeid
.
-
Opmerkingen
-
Een RAG-account moet worden geconfigureerd met de RAG-account configureren scriptstap voordat u deze functie kunt gebruiken.
-
Deze functie is handig om te controleren of er een RAG-ruimte bestaat voordat er bewerkingen op worden uitgevoerd. Als er voor een geldige RAG-account geen ruimte bestaat of er geen gegevens in staan, retourneert deze functie een foutbericht:
[RAG Space]-fout. Reden: Ruimte {space_id} niet gevonden
-
Als het RAG-account ongeldig is of niet bestaat, retourneert deze functie '?'.
-
De functie kan worden gebruikt voor het controleren en bewaken van RAG-ruimten binnen uw FileMaker-oplossing.
Voorbeeld 1
Hiermee krijgt u informatie over alle RAG-ruimten voor een geconfigureerd account met de naam "customer-support-rag-account".
GetRAGSpaceInfo ( "customer-support-rag-account" )
kan het volgende retourneren als twee RAG-ruimten gegevens bevatten:
{
"rag_space_list": [
{
"space_id": "knowledge-base",
"model": "multi-qa-MiniLM-L6-cos-v1"
},
{
"space_id": "meeting-notes",
"model": "multi-qa-MiniLM-L6-cos-v1"
}
]
}
Voorbeeld 2
Hiermee krijgt u informatie over een specifieke RAG-ruimte met de ID "knowledge-base".
GetRAGSpaceInfo ( "customer-support-rag-account" ; "knowledge-base" )
kan de volgende JSON retourneren voor een ruimte met een PDF-bestand genaamd "Policies.pdf" en een tekstdocument verdeeld in drie blokken (afgekapt voor beknoptheid).
{
"rag_space_id": "knowledge-base",
"model": "multi-qa-MiniLM-L6-cos-v1",
"entries": 4,
"values": [
{
"id": 1,
"filename": "Policies.pdf"
},
{
"id": 2,
"text": "Klantenservicebeleid en -procedures voor het verwerken van retourneringen en ruilingen..."
},
{
"id": 2,
"text": "Zorg ervoor dat het artikel dat u retourneert, opnieuw is verpakt met alle..."
},
{
"id": 2,
"text": "U hebt 14 kalenderdagen de tijd om een artikel te retourneren vanaf de datum waarop u het hebt ontvangen..."
}
]
}
Voorbeeld 3
Gebruikt GetRAGSpaceInfo in een script om te controleren of een RAG-ruimte bestaat voordat u bewerkingen uitvoert.
RAG-account configureren [ Naam van RAG-account: "customer-support-rag-account" ; Eindpunt: "https://myserver.example.com/llm/v1/" ; API-sleutel: Global::RAG_API_Key ; SSL-certificaten verifiëren ]
Variabele instellen [ $ragSpaceInfo ; Waarde: GetRAGSpaceInfo ( "customer-support-rag-account" ; "knowledge-base" ) ]
If [ PatternCount ( $ragSpaceInfo ; "[RAG Space] error" ) > 0 or PatternCount ( $ragSpaceInfo ; "?" ) > 0 ]
# RAG ruimte bestaat niet. Fout bij verwerken.
Aangepast dialoogvenster tonen [ "fout" ; "De opgegeven RAG-ruimte is niet gevonden." ]
Else
# RAG-ruimte bestaat. Ga verder met de werkzaamheden.
Variabele instellen [ $ragSpaceID ; Waarde: JSONGetElement ( $ragSpaceInfo ; "rag_space_id" ) ]
Aangepast dialoogvenster tonen [ "Ruimte gevonden" ; "RAG-ruimte '" & $ragSpaceID & "' is beschikbaar om te gebruiken." ]
End If