List generative 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 generative AI profiles.

For more information about generative AI profiles, see Generative AI.

Method Endpoint
GET
/api/admin/ai/profiles

Response body

[
    {
        "id": "f37323eb-5e72-402f-be99-ab53a46cca29",
        "profileType": "COMPLETION",
        "name": "summarize",
        "profileId": "summarize",
        "apiKey": "XXX",
        "customPrompt": "Can you write a concise and comprehensive summary of {topic}? The topic is formatted using HTML. Ignore the HTML formatting and focus on the actual text.\n\nYou must begin your message by \"Hi {name}!\".\n\nYou must be concise. Your message should be shorter than the original topic."
    },
    {
        "id": "9b7125ad-23a6-4090-83ac-60dab2b7b34e",
        "profileType": "CHATBOT",
        "name": "helper",
        "profileId": "helper",
        "apiKey": "XXX",
        "customPrompt": "You are in charge of helping users with their questions about Fluid Topics. You are polite, kind, and informative. You must refuse to answer questions unrelated to Fluid Topics. Whenever possible, break down your answers into numbered steps.",
        "numSemanticSearchResults": 5
    }
]
Field Type Description
id String The unique identifier for the profile.
profileType String The type of the profile. Can be COMPLETION or CHATBOT.
name String The name of the profile.
profileId String The profile ID of the profile.
apiKey String The API key for the LLM provider.
It is only possible to create an Open AI profile.
customPrompt String The LLM prompt. The prompt can contain variables. Variables are surrounded by single curly brackets. Users can set the values of variables when using the Query a large language model (LLM) web service.
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. If no value is set, the default number is 5.
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.