KosKrit
04/06/2025, 9:33 AMVapi Support Bot
04/06/2025, 9:35 AM// Use this (with toolID)
updateAssistant({ tools: [toolID] })
// Instead of this (with tool name)
updateAssistant({ tools: [toolName] })
### 2. Verify Prompt Instructions
Explicitly integrate the tool in your prompt by clearly specifying when and how the assistant should use it. For example:
If the user wants to know about something, use the `query` function with the parameter 'query', which will contain the user's question to initiate the process.
Vapi Support Bot
04/06/2025, 9:35 AMjson
{
"results": [
{
"toolCallId": "<your-tool-call-id>",
"name": "<your-function-name>",
"result": "Success" // Or any success message as a single-line string
}
]
}
### 4. Check Knowledge Base Configuration
Verify that your knowledge base is properly configured with the correct fileIds
and that the Knowledge Base ID is correctly associated with your assistant ([source](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1336051824402239579)).
### 5. Structure Your Prompt Properly
Organize your prompt into distinct sections for clarity:
- **Identity**: Define the assistant's role
- **Context**: Emphasize staying focused and providing relevant information
- **Tool Usage**: Clearly specify when and how to use the query tool
- **Response Guidelines**: Provide specific instructions on how the assistant should interact
Is there anything specific about your setup that you'd like me to help troubleshoot further?
Sources:
- [Troubleshooting "Couldn't Find Local Tool query" error](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1336674769055252594)
- [Possible causes for "Couldn't Find Local Tool query" error](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1338953413886480425)
- [Solutions for "Couldn't Find Local Tool query" error](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1342188078437236916)
- [Using query tool with knowledgebase and file for lookups](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1336051824402239579)
- [How to properly instruct assistant prompt to use query tool](https://docs.vapi.ai/prompting-guide)KosKrit
04/06/2025, 9:50 AMKosKrit
04/06/2025, 10:07 AMVapi Support Bot
04/06/2025, 10:08 AMtoolId
property should not be present in the tools
array. If it is, you might see error messages like:
"message": ["assistant.model.each value in tools.property toolId should not exist"]
The correct tool configuration for a function should include:
- type
(e.g., "function")
- functionName
(the name of your function)
- async
(boolean value)
- Any required parameters
### Dashboard Limitations and Bugs
There are some known issues with the Vapi dashboard interface:
- Adding headers to tools directly on the dashboard may not work due to a known bug
- Some users have reported that the dashboard UI doesn't always save settings correctly
- The dashboard only displays the 100 newest assistants, so if you have more, the one you're looking for might not be visible
### Tool Type SpecificationVapi Support Bot
04/06/2025, 10:08 AMtype
field for each tool in the tools
array is one of the allowed values:
dtmf, endCall, transferCall, voicemail, output, make, ghl, bash, computer, textEditor, function
Would you like me to help you troubleshoot any specific aspect of your tool configuration in more detail?
Sources:
- [Using toolID instead of tool name when configuring tools in the Vapi dashboard](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1338953413886480425)
- [Common tool configuration issues when using the Vapi dashboard to edit assistants](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1333880245681393756)
- [Troubleshooting tool configuration issues specifically within the Vapi dashboard](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1336715819333193740)
- [TERM_QUERY: What is a toolID in Vapi?](https://api.vapi.ai/knowledge-base)Kyle Brunker
04/06/2025, 11:52 AMKyle Brunker
04/06/2025, 11:58 AMdewi
04/06/2025, 12:46 PMVapi Support Bot
04/06/2025, 12:47 PMjson
{
"results": [
{
"toolCallId": "<your-tool-call-id>",
"name": "<your-function-name>",
"result": "Success" // Must be a single-line string without line breaks
}
]
}
According to [documentation](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1342188078437236916), a common mistake is using line breaks in the "result" field or using the tool ID instead of the tool call ID.
### 2. Verify Tool Configuration Structure
When configuring a function in the dashboard, make sure:
- The type
field is correctly set (e.g., "function")
- The functionName
is properly defined
- The async
parameter is set appropriately
- The toolId
property is NOT present in the tools
array
### 3. Check Variable Evaluation
According to [troubleshooting information](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1321375442644762625), the system might not be correctly evaluating variable paths before making the API call. Ensure that variable substitution is set up correctly.
### 4. Try Different Model or Cluster
Some users have reported success by switching to a different model like "gpt-4o" or using a different cluster instead of the real-time cluster, as mentioned in [this source](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1337465172263960637).
### 5. Properly Create the Tool CallVapi Support Bot
04/06/2025, 12:47 PMdewi
04/06/2025, 12:49 PMVapi Support Bot
04/06/2025, 12:51 PMtransferCall
function.
Could you please share more details about how you've configured the transferCall
function? Specifically:
1. Are you using the Vapi dashboard or API to configure it?
2. Have you checked if there's a conflict with any server events, particularly the 'phone-call-control' event?
3. What format are you using for the phone number in the forwardingPhoneNumber
parameter?
4. Are you using SIP for call transfers, and if so, is your system configured to handle SIP REFER messages?
This information would help me provide more targeted troubleshooting steps for the transferCall
function specifically.
Sources:
- [What is the transferCall function in Vapi?](https://docs.vapi.ai/call-forwarding)
- [What are potential issues with the transferCall function in Vapi?](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1330092161835733013)
- [What are the solutions for the "Couldn't Find Local Tool transferCall" error in Vapi?](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1339871158975336498)dewi
04/06/2025, 12:56 PMVapi Support Bot
04/06/2025, 12:57 PMtransferCall
function setup. Since it was working before Friday and suddenly stopped without any changes on your end, this sounds like it could be related to a recent platform update or a backend issue.
A few more questions to help narrow down the problem:
1. Have you checked the call logs for any error messages beyond the "Couldn't Find Local Tool transferCall" that appears in the chat?
2. When you say you've tried changing agent settings in the dashboard, which specific settings did you modify? Did you try removing and re-adding the transferCall
tool?
3. Are you using a custom LLM or the default Vapi-provided models? If custom, have you ensured the transferCall
tool is included in your custom LLM tools?
4. Have you tried testing with a simple call transfer to a single destination to rule out any issues with multiple destinations or complex routing logic?
Sources:
- [What are potential issues with the transferCall function in Vapi?](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1339614362742165606)
- [What are the solutions for the "Couldn't Find Local Tool transferCall" error in Vapi?](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1339871158975336498)
- [How to configure the transferCall function in Vapi?](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1335181348285054996)dewi
04/06/2025, 1:32 PMVapi Support Bot
04/06/2025, 1:33 PMtools
array. For GPT-4o, you need to ensure the tool is correctly configured with the appropriate parameters.
### 3. Check the response format
The correct format for tool call responses should be:
json
{
"results": [
{
"toolCallId": "<your-tool-call-id>",
"name": "<your-function-name>",
"result": "Success"
}
]
}
The result
must be a single-line string without line breaks, and you should use the tool call ID instead of the tool ID, as mentioned in [this source](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1342188078437236916).
### 4. Try a different approach to tool configuration
Since you mentioned you've already tried removing and re-adding the tool, consider:
- Using the API directly instead of the dashboard for configuration
- Not using "transferCall" as the tool call name (this is a [recommended tip](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1305244632124227654))
- Setting assistantOverrides
correctly if you're using silent transfersVapi Support Bot
04/06/2025, 1:33 PMforwardingPhoneNumber
attribute in your API calls, try setting it to null or an empty string to see if that resolves the issue, as suggested in [this source](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1333634755044048979).
### 6. Consider using a Twilio number
Some users have reported that using Twilio numbers for all parties involved in the call transfer resolved similar issues. Numbers purchased from Vapi might have reputation issues that could potentially block call forwarding, according to [user reports](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1338285744090906756).
Would any of these approaches be feasible for you to try? Also, have you noticed any error messages in your call logs beyond what appears in the chat?
Sources:
- [What are the solutions for the "Couldn't Find Local Tool transferCall" error in Vapi?](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1330092161835733013)
- [What are the solutions for the "Couldn't Find Local Tool transferCall" error in Vapi?](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1342188078437236916)
- [What are the solutions for the "Couldn't Find Local Tool transferCall" error in Vapi?](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1305244632124227654)
- [What are the solutions for the "Couldn't Find Local Tool transferCall" error in Vapi?](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1333634755044048979)
- [What are the solutions for the "Couldn't Find Local Tool transferCall" error in Vapi?](https://discord.com/channels/1211482211119796234/1211483291191083018/threads/1338285744090906756)KosKrit
04/06/2025, 8:25 PMKings_big💫
04/07/2025, 6:57 AMKyle Brunker
04/07/2025, 1:10 PMKosKrit
04/08/2025, 12:02 AMKyle Brunker
04/08/2025, 11:06 PM