القائمة
Integrate with [API_NAME] to [DESCRIPTION_OF_WHAT_IT_DOES]
Manage calendar events and schedules
Send and manage emails on behalf of the user
Create and manage personal notes and reminders
Automate [TASK_TYPE] tasks with scheduling and monitoring
A brief description of what this skill does
| name | api_service |
| version | 1.0.0 |
| description | Integrate with [API_NAME] to [DESCRIPTION_OF_WHAT_IT_DOES] |
| author | your_name |
| requires | ["api_key"] |
| tools | [{"name":"get_data","description":"Retrieve data from the API","parameters":[{"name":"query","type":"string","description":"Search query or identifier","required":true},{"name":"limit","type":"integer","description":"Maximum number of results to return","required":false,"default":10}]},{"name":"send_request","description":"Send a request to the API","parameters":[{"name":"endpoint","type":"string","description":"API endpoint to call","required":true},{"name":"method","type":"string","description":"HTTP method","required":false,"default":"GET","enum":["GET","POST","PUT","DELETE"]},{"name":"data","type":"object","description":"Request body data (for POST/PUT)","required":false}]}] |
This skill enables the agent to interact with [API_NAME].
Brief description of the API and its capabilities:
Before using this skill, configure it in your config.yaml:
skills:
api_service:
api_key: "${API_SERVICE_KEY}"
# api_base_url: "https://api.example.com" # Optional custom URL
# api_timeout: 30 # Optional timeout in seconds
Set the environment variable:
export API_SERVICE_KEY="your-api-key"
Use this tool to retrieve data from the API.
Parameters:
query (required): The search query or identifierlimit (optional): Maximum results (default: 10)Example:
User: "Search for X in the API"
Agent: Uses get_data with query="X"
Use this tool for advanced API operations.
Parameters:
endpoint (required): API endpoint pathmethod (optional): HTTP method (default: "GET")data (optional): Request body for POST/PUTExample:
User: "Create a new resource with these properties"
Agent: Uses send_request with method="POST" and data={...}
User: "Find information about X"
Agent: I'll search for that using the API.
[Calls get_data with query="X"]
Agent: Here's what I found: [results]
User: "Create a new entry with name 'Test' and value 123"
Agent: I'll create that entry for you.
[Calls send_request with method="POST", data={"name": "Test", "value": 123}]
Agent: Created successfully! The ID is [id].
User: "Update entry 456 to have value 789"
Agent: I'll update that entry.
[Calls send_request with endpoint="/entries/456", method="PUT", data={"value": 789}]
Agent: Entry 456 has been updated.
Common errors and how to handle them:
| Error | Cause | Solution |
|---|---|---|
| 401 Unauthorized | Invalid API key | Check configuration |
| 429 Too Many Requests | Rate limit exceeded | Wait and retry |
| 404 Not Found | Resource doesn't exist | Verify the ID/query |
| 500 Server Error | API issue | Try again later |