AI Tools
AI Tool Creator
Automatically create AI tools from API documentation
AI Tool Creator
The AI Tool Creator is a powerful feature that allows you to automatically generate tool configurations from API documentation URLs. This feature uses AI to analyze API documentation and extract the necessary parameters to create a functional tool.Overview
The AI Tool Creator simplifies the process of creating tools by:
- Analyzing API documentation to extract endpoints, parameters, and other details
- Automatically configuring the tool with the extracted information
- Reducing the manual work required to set up tools
How to Use the AI Tool Creator
Step 1: Access the Tool Creator
Navigate to the Tools section in your Popcorn dashboard and click on “Create New Tool”. The AI Tool Creator will be available at the top of the page.Step 2: Enter Documentation URL
Enter the URL of the API documentation you want to use. This can be:- OpenAPI/Swagger documentation
- API reference pages
- Developer documentation sites
Step 3: Extract API Information
Click the “Extract API Information” button to start the extraction process. The AI will analyze the documentation and extract:- Endpoint URL and method
-
Path parameters (automatically detected from URL patterns like
/users/{userId}) - Required headers
- Query parameters
- Body parameters
- Parameter types and descriptions
Step 4: Review and Edit
After extraction, the tool configuration will be automatically populated with the extracted information. Review the generated configuration and make any necessary adjustments.Step 5: Save Your Tool
Once you’re satisfied with the configuration, click “Save” to create your tool.Using Sample Data
If you want to see how the AI Tool Creator works before using your own API documentation, you can click the “Use Sample Data” button to populate the tool with sample API information.What the AI Tool Creator Extracts
The AI Tool Creator can extract the following information from API documentation:| Information | Description |
|---|---|
| Tool Name | A descriptive name based on the API functionality |
| Description | A summary of what the tool does |
| HTTP Method | GET, POST, PUT, DELETE, etc. |
| URL | The endpoint URL, including path parameters |
| Headers | Required HTTP headers for the API call |
| Query Parameters | URL parameters with types and descriptions |
| Body Parameters | Request body parameters with types and descriptions |
Limitations
While the AI Tool Creator is powerful, it has some limitations:- It works best with well-structured API documentation
- Some complex parameter structures may require manual adjustment
- Authentication details might need to be added manually
- The extraction quality depends on the clarity of the source documentation
Troubleshooting
If you encounter issues with the AI Tool Creator:- Extraction fails: Try using a more specific URL that points directly to the endpoint documentation
- Missing parameters: Check if the documentation clearly specifies all parameters and manually add any that are missing
- Incorrect parameter types: Review and adjust parameter types as needed
Next Steps
After creating your tool with the AI Tool Creator, you can:- Configure the tool settings
- Connect the tool to your AI agents
- Test the tool functionality in your applications