What you build
A retrieval tool the agent calls. The agent passes a query; Dextome returns ranked chunks the agent uses to plan its next step.
Features in play
- Project-scoped keys mean one customer can't reach another's tool catalog
- Metadata filtering for tool category, last-updated, owner
- Lower latency than re-embedding tools every turn
- Tier-1 isolation enforced at the access layer
ai-agents.ts
// agent's "retrieve tools" call
const tools = await fetch("https://api.dextome.com/v1/indexes/idx_tools/query", {
method: "POST",
headers: { Authorization: "Bearer $DEXTOME_KEY" },
body: JSON.stringify({
query: "tools related to charging a customer",
filter: { category: { eq: "billing" } },
top_k: 5,
rerank: true
})
});Reference architecture
agent
/v1/query (filter: category=billing)
ranked tool descriptors
agent plans next step