> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beam.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Submit feedback on the provided context



## OpenAPI

````yaml post /agent-setup/agent-context/feedback
openapi: 3.0.0
info:
  title: Public API
  description: Public endpoints to interact with agents and orchestrate tasks
  version: '1.0'
  contact: {}
servers:
  - url: https://api.beamstudio.ai
security: []
tags: []
paths:
  /agent-setup/agent-context/feedback:
    post:
      tags:
        - Agent Setup
      summary: Submit feedback on the provided context
      operationId: BeamAgentController_addIntroductionFeedback
      parameters:
        - name: current-workspace-id
          in: header
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FeedbackRequestDTO'
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentContextResponseDto'
      security:
        - x-api-key: []
components:
  schemas:
    FeedbackRequestDTO:
      type: object
      properties:
        query:
          type: string
          description: >-
            Feedback text or query about the agent setup. Use this to provide
            context, suggestions, or describe what kind of agent you want to
            create.
          example: I want to create an agent for invoice reconciliation
        threadId:
          type: string
          format: uuid
          description: >-
            UUID of the conversation thread to continue. This maintains context
            across multiple feedback requests.
          example: 1a2036c0-d533-4636-8f51-2a811763ef5c
      required:
        - query
        - threadId
    AgentContextResponseDto:
      type: object
      properties:
        threadId:
          type: string
          description: >-
            UUID of the conversation thread. Use this threadId in subsequent
            requests to maintain context across the agent setup process.
          example: 1a2036c0-d533-4636-8f51-2a811763ef5c
          format: uuid
        response:
          description: >-
            Generated agent suggestions including name, description, welcome
            message, setup message, personality, and category based on the
            provided query.
          allOf:
            - $ref: '#/components/schemas/AgentToolResponseDto'
      required:
        - threadId
    AgentToolResponseDto:
      type: object
      properties:
        name:
          type: string
          description: The name of the agent.
          example: Customer Support Agent
        description:
          type: string
          description: A brief description of what the agent does and its purpose.
          example: An AI agent that handles customer inquiries and provides support.
        agentWelcomeMessage:
          type: string
          description: >-
            The welcome message displayed when users first interact with the
            agent.
          example: >-
            Hello! I am your customer support assistant. How can I help you
            today?
        agentSetupMessage:
          type: string
          description: >-
            The setup message providing instructions or context during agent
            configuration.
          example: >-
            This agent is configured to handle billing inquiries and technical
            support.
        agentPersonality:
          type: string
          description: The personality traits and communication style of the agent.
          example: >-
            Friendly, professional, and helpful with a focus on resolving issues
            quickly.
        agentCategory:
          description: The category the agent belongs to.
          allOf:
            - $ref: '#/components/schemas/AgentCategoryDto'
        themeIconUrl:
          type: string
          description: URL of the theme icon for the agent.
          example: https://example.com/icons/support-agent.png
      required:
        - name
        - description
        - agentWelcomeMessage
        - agentSetupMessage
        - agentPersonality
        - agentCategory
    AgentCategoryDto:
      type: object
      properties:
        id:
          type: string
        title:
          type: string
      required:
        - id
        - title
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key

````