GetRAGSpaceInfo

Retorna informações sobre o espaço RAG especificado, ou todos os espaços RAG se nenhum ID de espaço for especificado.

Formato 

GetRAGSpaceInfo ( ragAccountName {; spaceID } )

Parâmetros 

ragAccountName - uma expressão de texto para o nome da conta RAG a ser usada. No arquivo atual, use a Etapa de script Configurar conta RAG para configurar a conta e atribuir esse nome a ela antes que a função seja usada.

spaceID - ID de um espaço RAG. Se omitido, retorna informações sobre todos os espaços RAG para a conta especificada.

Os parâmetros entre chaves { } são opcionais.

Tipo de dados retornado 

texto

Originada na versão 

22.0

Descrição 

GetRAGSpaceInfo retorna informações sobre espaços de geração de recuperação aumentada (RAG) no servidor do modelo de IA especificado por ragAccountName. Ele pode ser usado para verificar a existência de um espaço RAG, monitorar seu conteúdo e auditar as operações RAG.

Se nenhum valor spaceID for especificado, a função retornará um objeto JSON que contém uma matriz de espaços RAG disponíveis para a conta RAG especificada:

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

  • rag_space_list é uma matriz de espaços RAG.

  • space_id é a chave para um ID do espaço RAG.

  • model é a chave para o nome do modelo usado para gerar vetores de incorporação de texto neste espaço RAG.

Se um valor spaceID for especificado, a função retornará um objeto JSON que contém informações sobre o espaço RAG e os dados que ele contém:

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

  • rag_space_id é o ID do espaço RAG.

  • model é o nome do modelo usado para gerar vetores de incorporação de texto neste espaço RAG.

  • entries é o número de elementos na matriz values.

  • values é uma matriz de fragmentos de documentos de texto e nomes de arquivos PDF:

    • id é um ID numérico para o documento de texto de origem do fragmento de texto ou para um arquivo PDF.

    • filename é o nome de um arquivo PDF adicionado ao espaço.

    • text é um fragmento de um documento de texto adicionado ao espaço. Os fragmentos do mesmo documento de texto têm o mesmo id.

Notas 

  • Uma conta RAG deve ser configurada seguindo a Etapa de script Configurar conta RAG antes de usar essa função.

  • Esta função é útil para verificar se um espaço RAG existe antes que sejam executadas operações nele. Em uma conta RAG válida, se um espaço não existir ou não contiver dados, essa função retorna uma mensagem de erro:

    Erro [Espaço RAG]. Motivo: espaço RAG {space_id} não encontrado

  • Se a conta RAG for inválida ou não existir, esta função retornará "?".

  • A função pode ser usada para auditoria e monitoramento de espaços RAG dentro da sua solução FileMaker.

Exemplo 1 

Obtém informações sobre todos os espaços RAG para uma conta configurada chamada "customer-support-rag-account".

GetRAGSpaceInfo ( "customer-support-rag-account" ) pode retornar o seguinte se dois espaços RAG contiverem dados:

Copiar 
{
  "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"
    }
  ]
}

Exemplo 2 

Obtém informações sobre um espaço RAG específico com o ID "knowledge-base".

GetRAGSpaceInfo ( "customer-support-rag-account" ; "knowledge-base" ) pode retornar o seguinte JSON para um espaço com um arquivo PDF chamado "Policies.pdf" e um documento de texto dividido em três partes (truncado para ser breve).

Copiar 
{
  "rag_space_id": "knowledge-base",
  "model": "multi-qa-MiniLM-L6-cos-v1",
  "entries": 4,
  "values": [
    {
      "id": 1,
      "filename": "Policies.pdf"
    },
    {
      "id": 2,
      "text": "As políticas e os procedimentos de suporte ao cliente para lidar com devoluções e trocas..."
    },
    {
      "id": 2,
      "text": "Garante que o item que você está devolvendo seja reembalado com todos..."
    },
    {
      "id": 2,
      "text": "Você tem 14 dias corridos para devolver um item a partir da data de recebimento..."
    }
  ]
}

Exemplo 3 

Usa GetRAGSpaceInfo em um script para verificar se existe um espaço RAG antes de executar as operações.

Copiar 
Configurar conta RAG [ Nome da Conta RAG: "customer-support-rag-account" ; Ponto de extremidade: "https://myserver.example.com/llm/v1/" ; Chave de API: Global::RAG_API_Key ; Verificar certificados SSL ]

Definir variável [ $ragSpaceInfo ; Valor: GetRAGSpaceInfo ( "customer-support-rag-account" ; "knowledge-base" ) ]

Se [ PatternCount ( $ragSpaceInfo ; "Erro [RAG Space]" ) > 0 or PatternCount ( $ragSpaceInfo ; "?" ) > 0 ]

    # O espaço RAG não existe. Trate o erro.

    Mostrar caixa de diálogo personalizada [ "Erro" ; "O espaço RAG especificado não foi encontrado." ] 

Else

    # O espaço RAG existe. Prossiga com as operações.
    
    Definir variável [ $ragSpaceID ; Valor: JSONGetElement ( $ragSpaceInfo ; "rag_space_id" ) ]
    
    Mostrar caixa de diálogo personalizada [ "Espaço encontrado" ; "Espaço RAG '" & $ragSpaceID & "' está disponível para uso." ]

End If

Tópicos relacionados