Step 1: Create the tool
Open the node where most of the conversation happens, in this case Maya’s main support node. Scroll down and click Create a Tool, then choose External HTTP API. Name itget_cart_details.
The description matters more than anything else here. It’s what the agent reads to decide when to call the tool. Write it plainly: “Use this tool when the caller asks about cart details. It returns the cart’s products, quantities, total, and discounted total.”
Step 2: Attach the tool to the node
Creating the tool isn’t enough by itself. Go back to Maya’s node and selectget_cart_details under Tools, then save.
Step 3: Upload a Knowledge Base document
Click Upload Document, or go straight to Knowledge Base Files. Pick the document you want the agent to read from, a return policy, a shipping FAQ, whatever your customers actually ask about. Tig.ai automatically chunks and indexes the document, then retrieves only the relevant sections during a conversation. Upload it and wait for the status to say Completed.Step 4: Attach the document to the node
Same rule as the tool. Go back to Maya’s node, scroll to Knowledge Base Documents, and attach the file.Step 5: Tell the agent when to use each
In the node’s prompt, spell out which mechanism handles which question. Don’t leave it to guesswork:Step 6: Test it
Start a Web Call and try both:- “Hi Maya, what’s inside my cart?” Watch the transcript. Maya decides the tool is relevant, calls the API, and answers from the response instead of guessing.
- “What’s the return policy?” Maya retrieves the answer from the document and responds from that context.
Next Steps
You’ve now got the full loop: calls trigger automatically, data flows in and out, your number is connected, and the agent can act on live data and your own documents.- Full tool reference: parameter types, authentication, and best practices in HTTP API Tools.
- Full Knowledge Base reference: chunking behavior and embedding setup in Knowledge Base.