List AI profiles - Fluid Topics - Latest

Fluid Topics API Reference Guide
Category
Reference Guides
Audience
public
Version
Latest

This web service allows users with the ADMIN role to list AI profiles.

It is necessary to provide an Ft-Calling-App value when using Fluid Topics web services. See Fluid Topics calling app.

For more information about AI profiles, see AI.

Method Endpoint
GET 
/api/admin/ai/profiles

Response body

[
  {
    "id": "f37323eb-5e72-402f-be99-ab53a46cca29",
    "profileType": "COMPLETION",
    "name": "summarize",
    "profileId": "summarize",
    "apiKey": "XXX"
  },
  {
    "id": "9b7125ad-23a6-4090-83ac-60dab2b7b34e",
    "profileType": "CHATBOT",
    "name": "helper",
    "profileId": "helper",
    "apiKey": "XXX",
    "authenticationMethod": {
      "type": "api_key",
      "label": "API key",
      "authenticationParameters": [
        {
          "label": "API key",
          "key": "api_key",
          "value": "XXX",
          "isSecret": true,
          "isOptional": false
        }
      ]
    },
    "customPrompt": "This is my custom prompt."
  }
]
Field Type Description
id String The unique identifier for the profile.
profileType String The type of the profile. Can be COMPLETION, CHATBOT, or TRANSLATION.
name String The name of the profile.
profileId String The profile ID of the profile. It can only include alphanumeric characters, hyphens (-), and underscores (_).
apiKey String The API key for the Large Language Model (LLM) provider or translation provider.
numSemanticSearchResults Number The number of semantic search results provided to the large language model (LLM) when calling the Retrieval-augmented generation web service. The value can range from 1 to 20. By default, the value is 5.
numSemanticSearchResultsAfterRerank Number The number of semantic search results provided to the large language model (LLM) after reranking. The value must be smaller or equal to the value of the numSemanticSearchResults field.
ragPrompt String A Retrieval-augmented generation (RAG) prompt. Asks the user question to the LLM. It must have the {relevant_documents} variable, and the {chatbot_instructions} variable for Chatbot profiles. {relevant_documents} dynamically contains the relevant documents (gotten through the Clustered semantic search web service), and {chatbot_instructions} is the customPrompt value.
ragHistoryPrompt String A Retrieval-augmented generation (RAG) history prompt. Asks the LLM to transform the user question and the conversation history into a standalone question asked to the LLM.
translationAdvancedSettings String Only with TRANSLATION profiles. Parameters for the translation engine. Accepts JSON as a string.
authenticationMethod Object Contain the details for the authentication to the provider.
type String The type of authentication.
label String The label for the type of authentication.
authenticationParameters List of objects The list of parameters to connect to the provider.
label String The label for the authentication parameter.
key String The key for the authentication parameter.
value String The value for the authentication parameter.
isSecret Boolean Whether the parameter is secret or not.
isOptional Boolean Whether the parameter is optional or not.
customPrompt String The LLM prompt. The prompt can contain variables. Place variables in single curly brackets. Users can set the values of variables when using the AI method in Custom components, or the Query a large language model (LLM) web service.
Return code Description
200 OK The profile was created successfully.
401 UNAUTHORIZED The authorization header is absent or invalid.

For a comprehensive list of all possible return codes, see Return codes.

  • This web service returns the profiles list and updates in real time.
  • This web service does not list deleted profiles.
  • See the Analytics AI profiles web service to list profiles used to trigger AI events.