Tools
A tool is a capability an agent can invoke at runtime: an external API call or knowledge base query.
Project scope
Tools are managed under /projects/:appId/tools; they attach to agents via separate endpoints. Older “agent-scoped” endpoints may exist for backward compatibility.
Types
- API integration: REST call defined by
apiIntegrationId - Knowledge base: RAG query via
knowledgeBaseId
Mutual exclusion
A tool must not have both apiIntegrationId and knowledgeBaseId; validation will fail.
Static parameters (staticParams)
- fixed_value: Constant the LLM cannot change
- custom_attributes: Fields from session / user context
- Normal parameters: Arguments filled by the LLM