Agent Skill Component
Use the Agent Skill component to define a reusable capability or function for your agent. Think of a skill as a self-contained tool that the agent can learn to use, allowing you to build modular, powerful, and easily maintainable workflows.
What You’ll Configure
- Core Skill Definition
- Input Parameters
- Advanced Options
- Outputs
- Best Practices
- Troubleshooting Tips
- What to Try Next
Step 1: Define the Skill's Core Details
Give your skill a clear name and a detailed description so that both you and the AI understand its purpose.
Setting | Required? | Description | Example |
---|---|---|---|
Skill Name | Yes | A unique, descriptive name for the skill. | check_product_availability |
Instructions | Yes | A detailed description of what the skill does, which is used by the AI to understand when and how to use it. | This skill checks the inventory level for a given product ID and returns the stock count. |
Step 2: Define Input Parameters
Parameters are the inputs your skill needs to perform its function.
Field | Required? | Description |
---|---|---|
Name | Yes | A unique name for the parameter (e.g., product_id ). |
Type | Yes | The data type (e.g., String, Number, Boolean, Array, Object). |
Description | No | A clear explanation of what the parameter is for. |
Optional | No | Mark as true if the parameter is not always required. |
Default Value | No | A fallback value to use if no input is provided. |
Step 3: Configure Advanced Options
These settings control the skill's visibility to AI and can transform it into an API-like endpoint for more technical control.
Setting | Description |
---|---|
Exposed to AI | Enabled by default. When on, the skill is visible to AI models (like an LLM Assistant), which can then decide to use this skill autonomously based on the conversation. |
Description | An internal documentation field for developers to add notes about the skill. This is not visible to the AI. |
Advanced Request Parts | Disabled by default. Enabling this permanently transforms the skill to behave like an API endpoint, giving you access to HTTP methods (GET /POST ), headers, body, and query parameters. Use this for building skills that need to be triggered by external webhooks or services. |
Step 4: Understand the Outputs
The outputs of an Agent Skill depend on whether "Advanced Request Parts" is enabled.
Standard Outputs
By default, for every input parameter you create, a corresponding output with the same name is automatically generated. This allows you to easily pass the input data through to the components inside the skill.
Advanced Request Parts Outputs
When enabled, you get access to standard HTTP request components and can define custom outputs using JSON Path.
Output | Description |
---|---|
Headers | Contains metadata from the incoming request (e.g., Content-Type ). |
Body | The main content of the request, typically for POST methods. |
Query | The URL query parameters from the request, for GET methods. |
Custom | Define your own outputs by providing a name and a JSON Path expression to extract specific data from the body or headers (e.g., body.user.id ). |
Best Practices
- Keep Skills Focused: Each skill should do one thing well. Avoid creating a single, monolithic skill that handles many different tasks.
- Use Clear Naming: Use a consistent naming convention for your skills (e.g.,
verb_noun
) and parameters (productId
,userName
) to keep your agent organized. - Write Excellent Instructions: The quality of the
Instructions
field directly impacts how well the AI can use your skill. Be explicit about what it does, what it needs, and what it returns. - Expose to AI Intentionally: Only keep
Exposed to AI
enabled for skills you want an LLM to be able to trigger on its own. Turn it off for internal "helper" skills.
Troubleshooting Tips
What to Try Next
- Connect an LLM Assistant Component to your agent and have it use the skills you've built based on natural language commands.
- Create a "main" workflow that uses an Agent Skill Component to call other, more specialized skills, creating a modular architecture.
- Use the API Output Component at the end of a skill to define a standardized JSON response, especially if you have enabled Advanced Request Parts.