voicebot@v3

- action: voicebot@v3
  params:
    initialMessages:
      - role: system
        content: You are a smart AI agent on the phone. Make short replies
      - role: assistant
        content: Hello there. How can I help?
    engine:
      name: OpenAI # no API key needed, the default model of your account
    interruptions:
      mode: ignore

- action: voicebot@v3
  params:
    initialMessages:
      - role: system
        content: You are a smart AI agent on the phone. Make short replies
      # all assistant initial messages will be said by the bot
      - role: assistant
        content: Hello there. How can I help?
    engine:
      name: OpenAI # the only supported engine for now
      # no auth: no API key needed, the tokens are billed by Callr
      # no model: the default model of your account

- action: voicebot@v3
  params:
    initialMessages:
      - role: system
        content: You are a smart AI agent on the phone. Make short replies
      - role: system
        content: >
          If the call wants to speak to a human, call the "dial" function with phone_number='+15559824200'.
          If the user says goodbye or if the conversation is over, call the hangup function.
      - role: assistant
        content: Hello there. How can I help?
    engine:
      name: OpenAI
      model: gpt-6.1-terra
  result: $bot

- if: $bot?.exitTool === 'dial'
  then:
    - action: dial@v2
      params:
        targets:
          - number: ${{ $bot?.payload }}
            timeout: 30

- if: $bot?.exitTool === 'hangup'
  then:
    - action: play@v3
      params:
        tts:
          text: Thank you, goodbye!
    - action: hangup@v1

variables:
  $model: gpt-6.1-terra
  $url: "https://api.example.com"

branches:
  inbound-call:
    actions:
      - action: voicebot@v3
        params:
          initialMessages:
            - role: system
              content: You are an AI agent on the phone. Make short replies
            - role: system
              content: >
                If the call wants to speak to a human, call the "dial" function with phone_number='+15559824200'.
                If the user says goodbye or if the conversation is over, call the hangup function.
            - role: assistant
              content: Hello there. How can I help?
          engine:
            name: OpenAI
            model: ${{ $model }}
            auth: ${{ secrets.OPENAI_KEY }} # your own OpenAI key, optional
            params:
              maxCompletionTokens: 0 # default value
          pleaseWait:
            enabled: true
            delayBefore: 2.5
            delayAfter: 1
            sentences:
              - Please wait
          tools:
            - name: search_knowledge_base
              url: ${{ $url }}/search_knowledge_base
              description: >
                Search into the knowledge base (RAG). Do not call this function when
                looking for the next available slot.
              method: GET # GET is the default if you do not specify a method
              params: # parameters will be filled by the LLM
                # in case of a GET, they will be sent as query args
                - name: query
                  type: string
                  description: User query
            - name: get_next_available_slot
              url: ${{ $url }}/get_next_available_slot?from=${{ encodeURIComponent(call.fromNumber) }}
              description: >
                Returns the next available slot.
            - name: book_slot
              url: ${{ $url }}/book_slot
              description: >
                Books the slot.
              method: POST
              headers:
                # you can specify custom HTTP headers
                X-CallerID: ${{ call.fromNumber }}
                Authorization: Bearer ${{ secrets.API_TOKEN }}
              params:
                # those parameters will be sent as a JSON body (because method != GET)
                # and filled by the LLM
                - name: name
                  type: string
                  description: Firstname and lastname
                - name: object
                  type: string
                  description: Type of appointment
                - name: slot
                  type: string
                  description: ISO 8601 date-time "YYYY-MM-DDTHH:MM:SSZ"
        result: $bot

{
  "ok": true,
  "timeout": false,
  "exitTool": "hangup",
  "payload": "the caller has their appointment",
  "messages": [
    { "role": "assistant", "content": "Hello, how can I help you?" },
    { "role": "user", "content": "I'd like an appointment on Tuesday." },
    { "role": "assistant", "content": "Let me check." },
    { "role": "user", "content": "Yes, I'm listening." },
    { "role": "assistant", "content": "I can offer you 5pm." }
  ],
  "totalTokens": 2345,
  "transcript": [
    { "t": 0.02, "role": "assistant", "text": "Hello, how can I help you?", "status": "played", "id": 2 },
    { "t": 2.1, "role": "user", "text": "I'd like an appointment on Tuesday.", "status": "turn" },
    { "t": 4.5, "role": "assistant", "text": "Let me check.", "status": "played", "id": 4 },
    { "t": 5.3, "role": "assistant", "text": "I can offer you 5pm.", "status": "cut", "heard": "I", "id": 5 },
    { "t": 5.4, "role": "user", "text": "Yes, I'm listening.", "status": "turn" },
    { "t": 7.2, "role": "assistant", "text": "I can offer you 5pm.", "status": "played", "replayOf": 5, "id": 7 }
  ]
}