Tools & Services

One of the most powerful features of Rendez-vous.ai is its ability to perform real-world actions. The Core API achieves this through LLM Function Calling (Tools) and internal Services that integrate with external third-party APIs.

This document outlines how tools are structured and the key external integrations available in the ecosystem.

Tool Architecture

Tools are the functions that the LLM can “decide” to call based on the user’s input. The system uses a standardized wrapper (found in src/tools/lib/toolBuilder.ts and nativeAdapter.ts) to ensure compatibility across both Google Gemini and OpenAI.

Each tool consists of three main parts:

1. Description: A highly detailed text prompt explaining to the LLM exactly when and why it should use this tool.
2. Schema: A strict Zod schema defining the parameters the LLM must provide (e.g., date, location, party_size). The API automatically converts this Zod schema into the JSON Schema format required by the LLMs.
3. Execution Logic: The underlying Node.js function that actually performs the action (e.g., making an HTTP request to an external API) and returns a JSON response to the LLM.

Key Built-in Tools

The codebase contains a vast library of tools located in src/lib/tools/ and src/tools/. Depending on the Agent’s configuration in the Dashboard, a specific subset of these tools is injected into the LLM’s context.

📅 Calendar & Bookings

These tools are heavily utilized by local businesses (garages, doctors) to manage appointments. They interact with the client’s connected calendar via the Nylas API.

• suggestEventSlots: Checks the client’s calendar for available time slots on a specific date, ensuring no double-bookings.
• createEvent: Directly inserts a new appointment into the calendar.
• BookingRequestTool: A more complex state-machine tool that handles the entire booking flow (collecting user details, confirming the slot, and updating the Payload CMS database).

📞 Telephony Control

• transfer: Allows the AI to autonomously transfer an ongoing phone call to a human operator (e.g., “Let me connect you to a manager”). This triggers specific XML dialplan instructions back to FreeSWITCH.

🏢 Client-Specific Tools

Rendez-vous.ai handles highly specific domain logic for enterprise clients. For example, for casinos like Texapoker, the API includes custom integrations to fetch live data:

• searchTournaments: Queries the Texapoker database for upcoming poker tournaments based on buy-in, location, and date.
• getCasinos / searchFestivals: Provides contextual information about casino venues.

🌐 General Utility

• weather: Fetches real-time weather forecasts (useful for outdoor event planning or town hall agents).
• hubspot: Integrates with the HubSpot CRM to create or update contact records based on the conversation.
• querySitemap: Allows the AI to perform a semantic search against a client’s website sitemap to answer highly specific FAQs.

Internal Services

Beyond tools that the LLM calls directly, the API relies on internal services (src/services/) to handle asynchronous background tasks and notifications.

• Dashboard Services (src/services/dashboard/): A collection of helpers that wrap GenQL queries. These handle syncing completed calls, generating transcripts, and creating WebConversation logs in the Payload CMS database.
• Email Service (src/services/email.ts): Uses the Resend API to trigger transactional emails, such as notifying a business owner when a high-value appointment is booked or a VIP client calls.
• SMS Service (src/services/sms.ts): Handles outbound SMS messages (using providers like Twilio or Flowroute). This is often used to text the caller a confirmation link or a summary of their appointment immediately after they hang up.