GetRAGSpaceInfo

Devuelve información sobre el espacio RAG especificado o sobre todos los espacios RAG, si no se especifica ningún ID de espacio.

Formato 

GetRAGSpaceInfo ( ragAccountName {; spaceID } )

Parámetros 

ragAccountName: una expresión de texto para el nombre de la cuenta RAG que se va a utilizar. En el archivo actual, utilice el paso de guión Configurar cuenta RAG para configurar la cuenta y asignarle este nombre en cualquier momento antes de que se utilice la función.

spaceID: ID de un espacio RAG. Si se omite, devuelve información sobre todos los espacios RAG de la cuenta especificada.

Los parámetros entre llaves { } son opcionales.

Tipo de datos devuelto 

texto

Se origina en 

22.0

Descripción 

GetRAGSpaceInfo devuelve información sobre los espacios de generación aumentada por recuperación (RAG) en el servidor de modelos de IA especificado por ragAccountName. Puede utilizar este parámetro para verificar la existencia de un espacio RAG, supervisar su contenido y auditar las operaciones RAG.

Si no se especifica ningún valor de spaceID, la función devuelve un objeto JSON que contiene una matriz de espacios RAG disponibles para la cuenta RAG especificada:

Copiar 
{
  "rag_space_list": [
    {
      "space_id": "<string>",
      "model": "<string>"
    }
  ]
}

  • rag_space_list es una matriz de espacios RAG.

  • space_id es la clave de un ID de espacio RAG.

  • model es la clave del nombre del modelo utilizado para generar vectores de incrustación de texto en este espacio RAG.

Si se especifica un valor de spaceID, la función devuelve un objeto JSON que incluye información sobre el espacio RAG y los datos que contiene:

Copiar 
{
  "rag_space_id": "<string>",
  "model": "<string>",
  "entries": <number>,
  "values": [
    {
      "id": <number>,
      "filename": "<string>"
    },
    {
      "id": <number>,
      "text": "<string>"
    }
  ]
}

  • rag_space_id es el ID de espacio RAG.

  • model es el nombre del modelo utilizado para generar vectores de incrustación de texto en este espacio RAG.

  • entries es el número de elementos de la matriz values.

  • values es una matriz de fragmentos de documentos de texto y nombres de archivos PDF:

    • id es un ID numérico para el documento de texto del que procede un fragmento de texto o para un archivo PDF.

    • filename es el nombre de un archivo PDF añadido al espacio.

    • text es un fragmento de un documento de texto añadido al espacio. Los fragmentos del mismo documento de texto presentan el mismo id.

Notas 

  • Debe configurarse una cuenta RAG mediante el paso de guión paso de guión Configurar cuenta RAG antes de utilizar esta función.

  • Esta función es útil para verificar que existe un espacio RAG antes de realizar operaciones en él. En el caso de una cuenta RAG válida, si no existe un espacio o no hay datos en él, esta función devuelve un mensaje de error:

    Error de [espacio RAG]. Motivo: espacio RAG {space_id} no encontrado

  • Si la cuenta RAG no es válida o no existe, esta función devuelve "?".

  • La función puede utilizarse para la auditoría y la supervisión de los espacios RAG dentro de la solución de FileMaker.

Ejemplo 1 

Obtiene información sobre todos los espacios RAG de una cuenta configurada denominada "cuenta-rag-atención-cliente".

GetRAGSpaceInfo ( "cuenta-rag-atención-cliente" ) puede devolver lo siguiente si dos espacios RAG contienen datos:

Copiar 
{
  "rag_space_list": [
    {
      "space_id": "base-información",
      "model": "multi-qa-MiniLM-L6-cos-v1"
    },
    {
      "space_id": "notas-reunión",
      "model": "multi-qa-MiniLM-L6-cos-v1"
    }
  ]
}

Ejemplo 2 

Obtiene información sobre un espacio RAG específico con el ID "base-información".

GetRAGSpaceInfo ( "cuenta-rag-atención-cliente" ; "base-información" ) puede devolver el siguiente JSON para un espacio con un archivo PDF denominado "Políticas.pdf" y un documento de texto dividido en tres fragmentos (truncados por motivos de brevedad).

Copiar 
{
  "rag_space_id": "base-información",
  "model": "multi-qa-MiniLM-L6-cos-v1",
  "entries": 4,
  "values": [
    {
      "id": 1,
      "filename": "Políticas.pdf"
    },
    {
      "id": 2,
      "text": "Políticas y procedimientos de atención al cliente para gestionar las devoluciones y los cambios..."
    },
    {
      "id": 2,
      "text": "Asegúrese de que el artículo que va a devolver está embalado de nuevo con todo..."
    },
    {
      "id": 2,
      "text": "Dispone de 14 días naturales para devolver un artículo a partir de la fecha en que lo recibió..."
    }
  ]
}

Ejemplo 3 

Utiliza GetRAGSpaceInfo en un guión para verificar que existe un espacio RAG antes de realizar operaciones.

Copiar 
Configurar cuenta RAG [ Nombre de cuenta RAG: "cuenta-rag-atención-cliente" ; Punto de conexión: "https://myserver.example.com/llm/v1/" ; Clave de API: Global::Clave_API_RAG ; Verificar certificados SSL ]

Establecer variable [ $ragSpaceInfo ; Valor: GetRAGSpaceInfo ( "cuenta-rag-atención-cliente" ; "base-información" ) ]

If [ PatternCount ( $ragSpaceInfo ; "Error de [espacio RAG]" ) > 0 o PatternCount ( $ragSpaceInfo ; "?" ) > 0 ]

    # El espacio RAG no existe. Error de gestión.  Mostrar cuadro de diálogo personalizado [ "Error" ; "No se ha encontrado el espacio RAG especificado." ] 

Else

    # El espacio RAG no existe. Continúe con las operaciones.
    
    Establecer variable [ $ragSpaceID ; Valor: JSONGetElement ( $ragSpaceInfo ; "id_espacio_rag" ) ]
    
    Mostrar cuadro de diálogo personalizado [ "Espacio encontrado" ; "El espacio RAG '" & $ragSpaceID & "' está disponible para su uso." ]

End If

Temas relacionados