> ## Documentation Index > Fetch the complete documentation index at: https://docs.superoffice.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Chatbot Response > Return a chatbot response given prompt and previous turns. Stores the new turn in the history for the chatId NsApiSlow threshold: 2000 ms. ## Experimental: ## The AI agent is experimental, subject to change, and not intended for partners. ## OpenAPI ````yaml /openapi/agent/openapi-v3-AIAgent.json post /api/v1/Agents/AI/GetChatbotResponse openapi: 3.0.0 info: version: v1-Agents title: SuperOffice Agent API v1 description: SuperOffice Agent API - AIAgent contact: name: SuperOffice DevNet url: https://docs.superoffice.com/en/api/index.html email: sdk@superoffice.com servers: - url: http://localhost:56350 - url: https://localhost:56350 security: [] tags: [] externalDocs: description: >- The SuperOffice DevNet Community has more documentation, examples, and discussion forums. url: https://community.superoffice.com/en/developer/ paths: /api/v1/Agents/AI/GetChatbotResponse: post: tags: - AI_Agent summary: Get Chatbot Response description: "Return a chatbot response given prompt and previous turns.\n\nStores the new turn in the history for the chatId\r\nNsApiSlow threshold: 2000 ms.\r\n## Experimental: ## The AI agent is experimental, subject to change, and not intended for partners." operationId: v1AIAgent_GetChatbotResponse parameters: - name: $select in: query description: >- Optional comma separated list of properties to include in the result. Other fields are then nulled out to reduce payload size: "Name,department,category". Default = show all fields. required: false schema: type: string - name: Accept-Language in: header description: >- Convert string references and multi-language values into a specified language (iso2) code. required: false schema: type: string - name: SO-Language in: header description: >- Convert string references and multi-language values into a specified language (iso2) code. Overrides Accept-Language value. required: false schema: type: string - name: SO-Culture in: header description: >- Number, date formatting in a specified culture (iso2 language) code. Partially overrides SO-Language/Accept-Language value. Ignored if no Language set. required: false schema: type: string - name: SO-TimeZone in: header description: >- Specify the timezone code that you would like date/time responses converted to. required: false schema: type: string - name: SO-AppToken in: header description: >- The application token that identifies the partner app. Used when calling Online WebAPI from a server. required: false schema: type: string requestBody: content: application/json: schema: $ref: >- #/components/schemas/SuperOffice.WebApi.v1.Carriers.AICarriers.GetChatbotResponseRequest text/json: schema: $ref: >- #/components/schemas/SuperOffice.WebApi.v1.Carriers.AICarriers.GetChatbotResponseRequest application/xml: schema: $ref: >- #/components/schemas/SuperOffice.WebApi.v1.Carriers.AICarriers.GetChatbotResponseRequest text/xml: schema: $ref: >- #/components/schemas/SuperOffice.WebApi.v1.Carriers.AICarriers.GetChatbotResponseRequest application/x-www-form-urlencoded: schema: $ref: >- #/components/schemas/SuperOffice.WebApi.v1.Carriers.AICarriers.GetChatbotResponseRequest application/json-patch+json: schema: $ref: >- #/components/schemas/SuperOffice.WebApi.v1.Carriers.AICarriers.GetChatbotResponseRequest application/merge-patch+json: schema: $ref: >- #/components/schemas/SuperOffice.WebApi.v1.Carriers.AICarriers.GetChatbotResponseRequest description: ChatId, IsoLangCode, UserPrompt, DisplayValue, PreviousTurns, ApiUrl required: true responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.ChatbotTurn' text/json: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.ChatbotTurn' application/xml: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.ChatbotTurn' text/xml: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.ChatbotTurn' application/json-patch+json: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.ChatbotTurn' application/merge-patch+json: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.ChatbotTurn' security: - SuperOffice_Password: [] SuperId_Authentication: [] components: schemas: SuperOffice.WebApi.v1.Carriers.AICarriers.GetChatbotResponseRequest: description: >- GetChatbotResponse: Return a chatbot response given prompt and previous turns. Stores the new turn in the history for the chatId type: object properties: ChatId: type: string IsoLangCode: type: string UserPrompt: type: string DisplayValue: type: string PreviousTurns: type: array items: $ref: '#/components/schemas/SuperOffice.CRM.Services.ChatbotTurn' ApiUrl: type: string SuperOffice.CRM.Services.ChatbotTurn: description: "Chat turn contains one user question, an optional display value for the user prompt, and one chatbot response.\r\n\r\nCarrier object for ChatbotTurn.\r\nServices for the ChatbotTurn Carrier is available from the AI Agent." type: object properties: Timestamp: format: date-time description: UTC timestamp for turn - when response was generated. type: string UserPrompt: description: Text from the user type: string UserDisplayText: description: Optional display value to use instead of the the UserPrompt type: string BotResponse: description: Text from the chatbot type: string BotActions: description: >- optional dictionary of action buttons. Key = Display text, Value = Prompt text type: object additionalProperties: type: string Attachments: description: optional array of attachments - can be URL or Base64 encoded data type: array items: type: string ```` ## Related topics - [SuperOffice.WebApi.Data.AI GetChatbotResponseRequest](/en/api/reference/webapi/SuperOffice.WebApi.Data.AI_GetChatbotResponseRequest.md) - [SuperOffice.WebApi.Agents.AIAgent](/en/api/reference/webapi/SuperOffice.WebApi.Agents.AIAgent.md) - [SuperOffice.WebApi.Agents.IAIAgent](/en/api/reference/webapi/SuperOffice.WebApi.Agents.IAIAgent.md) - [Get Chatbot Turns](/en/api/reference/restful/agent/ai_agent/get-chatbot-turns.md) - [Get Chatbot Prompt Suggestions](/en/api/reference/restful/agent/ai_agent/get-chatbot-prompt-suggestions.md) - [SuperOffice.WebApi.Data.AI GetChatbotTurnsRequest](/en/api/reference/webapi/SuperOffice.WebApi.Data.AI_GetChatbotTurnsRequest.md)