Overview
Actions extend your Guru’s capabilities by connecting it to external APIs and services. When users ask questions that require real-time data, your Guru can automatically trigger these actions to fetch information and provide up-to-date responses.What Actions Enable
Actions transform your Guru into a dynamic assistant that can:- Fetch real-time data from external APIs
- Retrieve current information like weather, stock prices, or user details
- Integrate with third-party tools and platforms
Action Limits
Each Guru has a limit on the number of actions (e.g., “1 of 10 actions used”).How Actions Work
Actions use an intelligent trigger system:- Condition Prompt Evaluation: The Guru checks if the user’s question matches your defined conditions (based on Condition Prompt)
- Parameter Extraction: Parameters are extracted from the user’s question based on your descriptions
- Execution Decision: The action runs only if all required parameters can be extracted (or have default values)
- API Call and Response: The configured API call is made, and the Usage Prompt instructs the AI how to use the response
Creating an Action
Step 1: General Configuration
Action Name
Provide a descriptive name that appears in your actions list.Description
Explain what this action does and when it should be used.Condition Prompt
Describe when this action should be triggered. Be specific to ensure it only runs when appropriate. Example: “When a question about a Github user is asked.”
Parameters Configuration
Each parameter includes:- Parameter Name: Use only letters and underscores (e.g.,
username,user_id) - Type: Choose from String (text), Number (numeric), or Boolean (true/false)
- Description: Clear description for parameter extraction from user questions
- Required: Check if essential for the action to work
- Default Value: Optional fallback when parameter can’t be extracted
Step 2: API Configuration
HTTP Method
Select fromGET, POST, PUT, PATCH, DELETE.
Endpoint URL
Enter the API endpoint. It supports parameters like{param_name}
Example: https://api.github.com/users/{username}
Headers
Configure authentication or content type headers. It supports parameters like{param_name}
Example: Authorization: Bearer {token}
Request Body (JSON)
ForPOST, PUT, and PATCH methods, include JSON payload. It supports parameters like {param_name}
Usage Prompt
Provide instructions for how the AI should interpret and use the API response data. Example: “Analyze the JSON of the given user and provide a summary of their GitHub profile information.”Testing Your Action
Managing Actions
Actions List
View all configured actions with their name, description, type (“API Call”), and status (Enabled/Disabled).For now, only the “API Call” type is implemented. We are planning to add new types of actions in the future.
Action Management Options
- Edit: Modify the action’s configuration
- Disable: Temporarily disable without deleting
- Delete: Permanently remove the action
Enabling and Disabling Actions
Enable or disable actions at any time. Disabled actions won’t be triggered by user questions.Usage in the Answer
Actions used in the answer are shown as below with the action name:
Common Mistakes to Avoid
1. Vague Condition Prompts
❌ Poor: “When asking about data” ✅ Good: “When asking about current weather conditions for a specific location”2. Inadequate Parameter Descriptions
❌ Poor: Parameter name:id, Description: “The ID”
✅ Good: Parameter name: user_id, Description: “The unique identifier for the GitHub user whose profile information is being requested”