Tools

Features & Capabilities

• Forms: Collect structured data from users
• Buttons: Present actionable choices
• Charts: Visualize data in various formats
• Content Display: Present formatted content

How to Use

• User Information Requests:

  user_info_request({
    "props": {
      "prompt": "Please enter your contact information",
      "schema": {
        "type": "object",
        "properties": {
          "name": {"type": "string", "title": "Full Name"},
          "email": {"type": "string", "title": "Email", "format": "email"}
        },
        "required": ["name", "email"]
      }
    }
  })
  

• Button Choices:

  show_buttons({
    "props": {
      "title": "What would you like to do?",
      "buttons": [
        {"text": "Create New Record", "value": "create"},
        {"text": "Search Records", "value": "search"}
      ]
    }
  })
  

• Data Visualization:

  present_chart({
    "props": {
      "type": "bar",
      "title": "Sales by Region",
      "data": [
        {"name": "North", "value": 200},
        {"name": "South", "value": 300},
        {"name": "East", "value": 150},
        {"name": "West", "value": 250}
      ]
    }
  })
  

Best Practices

• Clear Instructions: Provide users with clear prompts and guidance
• Validation: Use appropriate schema validation for form inputs
• Progressive Disclosure: Present complex forms in logical stages
• Responsive Design: Ensure UI components work well on various devices
• Accessibility: Use descriptive labels and provide adequate context

Integration Tools

Features & Capabilities

• API Connections: Interface with external services
• Authentication: Manage OAuth, API keys, and tokens
• Data Exchange: Send and receive data from external systems
• Webhook Processing: Handle incoming webhook data

How to Use

• API Requests:

  fetch_request(
    url="https://api.example.com/data",
    method="GET",
    headers={"Authorization": "Bearer token"}
  )
  

• Authentication Flows:

  handleAppLogin(app_id="app_id")
  

Best Practices

• Error Handling: Gracefully handle API failures and rate limits
• Authentication Management: Store tokens securely
• Data Transformation: Process API responses before storing or displaying
• Rate Limiting: Implement thoughtful retry strategies
• Logging: Monitor API interactions for troubleshooting

Memory Tools

Features & Capabilities

• Contextual Storage: Save important information for later reference
• Memory Types: User, agent, and workspace memories
• Context Retrieval: Find relevant information based on topics
• Memory Management: Create, update, and forget memories

How to Use

• Creating Memories:

  create_user_memory(name="preference", value="dark mode")
  

• Retrieving Memories:

  remember(topic="user preferences")
  

• Forgetting Memories:

  forget(id="memory_id")
  

Best Practices

• Structured Storage: Use consistent naming conventions
• Meaningful Context: Store complete, useful information
• Privacy Considerations: Only store necessary information
• Memory Types: Use appropriate memory types for different contexts
• Regular Cleanup: Remove outdated or unnecessary memories

Web Tools

Features & Capabilities

• HTTP Requests: Make requests to external web resources
• Response Processing: Handle and parse various response formats
• Error Handling: Manage timeouts, failures, and unexpected responses

How to Use

• Web Requests:

  fetch_request(
    url="https://example.com/api/data",
    method="POST",
    body=JSON.stringify({"query": "information"}),
    headers={"Content-Type": "application/json"}
  )
  

Best Practices

• URL Validation: Ensure URLs are properly formatted
• Response Parsing: Handle different content types appropriately
• Error Handling: Implement robust error handling for various response codes
• Timeout Management: Set appropriate timeouts for requests
• Rate Limiting: Respect API rate limits and implement backoff strategies
• Content Processing: Strip HTML when only text content is needed