You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1.2 KiB
1.2 KiB
Concept: Mastra Agents & Tools
Purpose: Reusable units of logic and LLM-powered entities.
Last Updated: 2026-01-09
Core Idea
Agents are specialized LLM configurations that use Tools to interact with external systems or perform specific logic. Tools are the building blocks that provide functionality to both agents and workflows.
Key Points
- Agents: Defined with a
name,instructions, andmodel. They can be assigned a set oftools. - Tools: Defined with
id,inputSchema,outputSchema, and anexecutefunction. - Type Safety: Both agents and tools use Zod for schema validation.
- Standalone Use: Tools can be executed independently of agents, making them highly reusable.
Quick Example
// Tool
const myTool = createTool({
id: 'my-tool',
inputSchema: z.object({ query: z.string() }),
execute: async ({ inputData }) => ({ result: `Processed ${inputData.query}` }),
});
// Agent
const myAgent = new Agent({
name: 'My Agent',
instructions: 'Use my-tool to process queries.',
model: { provider: 'OPEN_AI', name: 'gpt-4o' },
tools: { myTool },
});
Reference: src/mastra/agents/, src/mastra/tools/
Related:
- concepts/core.md
- concepts/workflows.md