replace forwardingPhoneNumber with Tools

Author: hackthehackerman

fern/examples/inbound-support.mdx

@@ -29,18 +29,29 @@ As a bonus, we also want the assistant to remember by the phone number of the ca
               "role": "system",
               "content": "You're a technical support assistant. You're helping a customer troubleshoot their Apple device. You can ask the customer questions, and you can use the following troubleshooting guides to help the customer solve their issue: ..."
           }
-        ]
+        ],
+      "tools": [
+        {
+          "type": "transferCall",
+          "destinations": [
+            {
+                "type": "number",
+                "number": "+16054440129",
+                "message": "I am forwarding your call to Department A. Please stay on the line."
+            }
+          ]
+        }
+      ]
       },
-      "forwardingPhoneNumber": "+16054440129",
       "firstMessage": "Hey, I'm an A.I. assistant for Apple. I can help you troubleshoot your Apple device. What's the issue?",
       "recordingEnabled": true,
     }
     ```
     <Card title="Let's break this down">
     - `transcriber` - We're defining this to make sure the transcriber picks up the custom words related to our devices.
     - `model` - We're using the OpenAI GPT-3.5-turbo model. It's much faster and preferred if we don't need GPT-4.
+    - `transferCall` tool in `model.tools` - Since we've added this, the assistant will be provided the [transferCall](/assistants#transfer-call) function to use if the caller asks to be transferred to a person.
     - `messages` - We're defining the assistant's instructions for how to run the call.
-    - `forwardingPhoneNumber` - Since we've added this, the assistant will be provided the [transferCall](/assistants#transfer-call) function to use if the caller asks to be transferred to a person.
     - `firstMessage` - This is the first message the assistant will say when the user picks up.
     - `recordingEnabled` - We're recording the call so we can hear the conversation later.
 

fern/examples/outbound-sales.mdx

@@ -28,8 +28,8 @@ We want this agent to be able to call a list of leads and schedule appointments.
               "content": "You're a sales agent for a Bicky Realty. You're calling a list of leads to schedule appointments to show them houses..."
           }
         ],
-        "functions": [
-          {
+      "tools": [
+        {
             "name": "bookAppointment",
             "description": "Used to book the appointment.",
             "parameters": {
@@ -41,14 +41,23 @@ We want this agent to be able to call a list of leads and schedule appointments.
                 }
               }
             }
-          }
-        ]
+        }
+        {
+          "type": "transferCall",
+          "destinations": [
+            {
+                "type": "number",
+                "number": "+16054440129",
+                "message": "I am forwarding your call. Please stay on the line."
+            }
+          ]
+        }
+      ]
       },
       "voice": {
         "provider": "openai",
         "voiceId": "onyx"
       },
-      "forwardingPhoneNumber": "+16054440129",
       "voicemailMessage": "Hi, this is Jennifer from Bicky Realty. We were just calling to let you know...",
       "firstMessage": "Hi, this Jennifer from Bicky Realty. We're calling to schedule an appointment to show you a house. When would be a good time for you?",
       "endCallMessage": "Thanks for your time.",
@@ -60,9 +69,9 @@ We want this agent to be able to call a list of leads and schedule appointments.
     - `transcriber` - We're defining this to make sure the transcriber picks up the custom word "Bicky"
     - `model` - We're using the OpenAI GPT-4 model, which is better at function calling.
     - `messages` - We're defining the assistant's instructions for how to run the call.
-    - `functions` - We're providing a bookAppointment function with a datetime parameter. The assistant can call this during the conversation to book the appointment.
+    - `bookAppointment` in `model.tools` - We're providing a bookAppointment function with a datetime parameter. The assistant can call this during the conversation to book the appointment.
+    - `transferCall` in `model.tools` - Since we've added this, the assistant will be provided the [transferCall](/assistants#transfer-call) function to use.
     - `voice` - We're using the Onyx voice from OpenAI.
-    - `forwardingPhoneNumber` - Since we've added this, the assistant will be provided the [transferCall](/assistants#transfer-call) function to use.
     - `voicemailMessage` - If the call goes to voicemail, this message will be played.
     - `firstMessage` - This is the first message the assistant will say when the user picks up.
     - `endCallMessage` - This is the message the assistant will deciding to hang up.
@@ -141,7 +150,7 @@ We want this agent to be able to call a list of leads and schedule appointments.
     }
     ```
 
-    Since we also defined a `forwardingPhoneNumber`, when the user asks to speak to a human, the assistant will transfer the call to that number automatically.
+    Since we also defined a `transferCall` tool, when the user asks to speak to a human, the assistant will transfer the call to that number automatically.
 
     We can then check the [Dashboard](https://dashboard.vapi.ai) to see the call logs and read the transcripts.