Tools, Skills, and Hooks
Capabilities, instructions, and runtime automation for Galadri agents.
Tools are agent capabilities, not separate APIs your app has to call. Your application sends normal messages to /v1/chat. The agent decides when a configured capability is useful, Galadri runs it server-side, and your app receives the streamed answer plus any rich results it should render.
The AI uses the tools
Developers enable capabilities, provide credentials, set data access, and render results. The AI agent chooses when to search, look up vehicle data, send a message, save user data, or use a custom capability during the conversation.
What you configure
- Agent capabilities: Enable the built-in and custom capabilities each agent is allowed to use.
- Skills: Add static playbooks or policies the agent can reference only when they are relevant to the turn.
- Runtime hooks: Choose whether a custom capability can run before a message, during a conversation when the agent needs it, or at the end of a message.
- Credentials: Connect provider credentials for communication channels, push webhooks, custom HTTP capabilities, and telematics.
- Data access: Decide which end-user tables an agent may read or update.
- UI rendering: Render text, maps, cards, saved data events, and other rich results from the chat stream.
Built-in capabilities
Enable built-ins from the agent builder. Some capabilities also require setup on the Credentials page before the agent can use them.
Automotive
Google Maps Search
Find businesses and places with addresses, phone numbers, ratings, websites, hours, and location data.
Directions and Traffic
Get route directions, live travel time, traffic delays, and nearby incidents.
Route Planner
Optimize multi-stop routes, compare travel times, and render route maps for delivery or field-service workflows.
Geocoding
Convert addresses to coordinates, or coordinates back to parsed street addresses.
Gas Price Lookup
Find nearby stations, current fuel prices, and cheapest available prices by fuel grade.
EV Charging Stations
Find public chargers with network, connector, port-count, pricing, and access-hour details.
Recalls: Make and Model
Search NHTSA recall campaigns for a year, make, and model.
VIN Decode
Decode VINs into structured vehicle specifications that can populate vehicle records.
Valuation
Estimate dealer retail market value from VIN, mileage, dealer type, and location, with automatic valuation sync and provenance for saved vehicles.
Sales Listings
Search active dealer inventory and resolve MarketCheck dealership identifiers for exact dealer-specific inventory. Best-pick searches can inspect up to 300 listings server-side while returning a short candidate list.
Automaker Incentives
Find manufacturer rebates, lease offers, and financing programs for new vehicles.
Vehicle Telemetry
Read live DIMO-backed snapshots, recent trips, and compact telemetry analysis for saved vehicles.
Requires an organization-owned DIMO credential and a saved vehicle mapping.
Communications
Email and Calendar
Send emails, create calendar invites, and cancel calendar invites through configured SendGrid credentials. Agent-authored emails include unsubscribe content and one-click unsubscribe headers automatically, and provider click tracking is disabled so links stay direct.
Requires an email credential.
SMS
Send SMS and MMS messages through configured Twilio credentials. First-contact SMS disclosure and STOP/START preference tracking are applied automatically.
Requires an SMS-capable Twilio number.
Phone Call
Place AI-powered phone calls through configured Twilio voice credentials and Galadri-managed voice runtime. Live voice agents can use enabled communication tools during calls, and clear no-more-calls requests are stored as call opt-outs.
Requires a voice-capable Twilio number.
Push Notification
Send signed push events to your backend so your app can deliver mobile or in-app notifications. Webhooks can also be configured to fire chat.completed after every successful Chat API run.
Requires a push webhook credential.
General, data, and memory
Web Search: Basic
Answer simple real-time questions with quick web results.
Web Search: Advanced
Run deeper web search, page extraction, site crawling, and site mapping for research-heavy questions.
Calculator
Evaluate math expressions and common unit conversions.
File Analysis
Analyze hosted files and console uploads, including images, PDFs, documents, and spreadsheets.
Image Generation
Generate one 1024x1024 transparent PNG image from a text prompt through the OpenAI Images API. Image generation is billed per generated image as tool usage, separate from model token spend.
User Data
Read and update user profiles, and optionally delete vehicles, vehicle groups, documents, milestones, and schedules when the agent has matching data access.
Controlled by the agent data-access settings.
Conversation Memory
Search prior conversation context for the active end user when the user refers to something discussed earlier.
Result shapes
Many capabilities produce structured result IDs for maps, cards, schemas, saved data, or route displays. Use the Rich Results guide for the UI contract your frontend should implement.
Telemetry map results
Vehicle telemetry snapshots can return a map_item_id for the latest known vehicle location. Trip and analysis results can return route_ids for route maps. Put related IDs together in one display directive with layout:"map" when the user wants one combined map.
Snapshot telemetry also updates the saved vehicle record when vehicle write access is enabled, DIMO returns timestamped odometer, location, or DTC values, and the VINs do not conflict. Galadri writes the latest odometer, last known latitude and longitude, active DTC codes, and associated refresh timestamps automatically, and skips stale provider timestamps.
Valuation lookups for saved vehicles can also update the vehicle record. Galadri stores the best available dealer-retail estimate in retail_valuation_cents and its refresh time in last_valuation_update_utc with valuation_source and valuation_method so applications can distinguish VIN-specific pricing from fallback comps. valuation_insight and time_to_sell_score are not tool-written provenance fields. They are judgment fields for the agent or your application to update when the new value changes the user-facing recommendation.
If MarketCheck Price cannot price a valid VIN but the VIN can still be decoded, valuation responses may include a clearly labeled rough estimate from active MarketCheck listings. Galadri starts with a tight mileage window and widens only when there are too few comps, then persists the estimate with fallback provenance.
Combined route-map marker numbers follow the final display directive item order and do not restart per vehicle or table. If you render a table for mapped trips, use the same global order for the Map # column and keep any per-vehicle trip number in a separate column.
Trip results support explicit chronological or recent-first ordering. Bounded calendar windows such as a day, weekend, or explicit date range default to chronological order when no order is specified, but mapped trip tables should always mirror the returned route ID order.
Custom capabilities
Custom capabilities let an agent use your systems alongside Galadri's built-ins. Create them in the Tools page, then attach them to one or more agents.
- HTTP capabilities: Call your own HTTPS endpoints with a schema the agent can fill from the conversation.
- MCP capabilities: Connect to a Model Context Protocol server for dynamic capabilities exposed by your infrastructure.
- Skills: Give the agent compact static instructions or playbooks it can fetch when relevant.
Runtime hooks
Hooks are runtime settings on a custom capability. They are useful when your app needs a predictable integration point around every message instead of waiting for the agent to decide whether a capability is relevant.
- Start hook: Runs at the beginning of a turn. Use this to load external account state, sync a CRM record, refresh a profile, or fetch per-request context before the answer is produced.
- AI-selected: Makes the capability available during the conversation when the agent determines it is needed.
- End hook: Runs at the end of a turn. Use this for audit logs, analytics, follow-up webhooks, CRM notes, or finalization work after the agent has enough information.
Hooks and session context
Start hook results are added to the current turn before the main answer. If a start hook updates Galadri-managed user data, the runtime data snapshot is refreshed before the model continues. See Sessions for the exact data context Galadri loads by default.
Keep custom capability secrets server-side
Store API keys, bearer tokens, and other custom capability secrets as credentials in Galadri. Reference credentials from headers or request bodies, never from URLs. Use HTTPS for endpoints that receive private data or credentials.
Setup guides
- Communications covers SendGrid, Twilio, inbound behavior, and signed callbacks.
- Telematics covers storing DIMO credentials and mapping Galadri vehicles to provider vehicle IDs.
- Data Model covers the end-user tables agents can read and update.
- Rich Results covers frontend rendering for maps, cards, routes, schemas, and saved-data events.