AgentConfiguration

  • agent
    Type: object
    required

    Core agent behaviour settings

    • first_message
      Type: string
      required

      Opening message the agent speaks at the start of each conversation

    • knowledge_base
      Type: array object[] ยท KnowledgeBaseItem[]
      required

      Knowledge base documents available for retrieval-augmented generation

    • language
      Type: string
      required

      BCP 47 language code (e.g. en-US)

    • prompt
      Type: object
      required

      LLM prompt configuration

  • asr
    Type: object
    required

    Automatic speech recognition settings

    • keywords
      Type: array string[]
      required

      Words/phrases to boost recognition accuracy for domain vocabulary

  • conversation
    Type: object
    required

    Conversation-level constraints

    • max_duration_seconds
      Type: number
      required

      Hard upper limit on conversation length in seconds

  • tts
    Type: object
    required

    Text-to-speech settings

    • settings
      Type: object
      required

      Fine-grained voice synthesis parameters

    • voice_id
      Type: string

      Voice ID to use for speech synthesis

  • turn
    Type: object
    required

    Turn detection and timing settings

    • silence_timeout_seconds
      Type: number
      required

      Seconds of silence after speech that triggers turn completion

    • timeout_seconds
      Type: number
      required

      Maximum seconds to wait for a response before ending the turn

  • analysis
    Type: object

    Optional configuration for call analysis and data collection.

    • data_collection
      Type: object

      A map of data collection items, where keys are custom identifiers.