sii_cognitions - SII Cognitions Search

Overview

The sii_cognitions tool accesses and searches cognitions from the SII backend. It can list cognitions with various filters or get detailed information about specific cognitions. Only available when authenticated with SII.

Tool Name

• Internal Name: sii_cognitions
• Display Name: SII Cognitions
• Icon: Brain

Prerequisites

To use this tool, you need:

1. SII Account: A valid SII account is required
2. Authentication: Must be authenticated with SII
3. Environment Variables:
   • SII_USERNAME: SII username
   • SII_PASSWORD: SII password

Parameters

Required Parameters

Parameter	Type	Description
action	string	The action to perform: "list" for getting cognitions list, "detail" for getting specific cognition details.

Optional Parameters (for "list" action)

Parameter	Type	Description
search	string	Search keyword for filtering cognitions.
topics	string[]	Topics to filter by (e.g., ["AI", "Technology"]).
author_filter	string	Author filter.
source_filter	string	Source filter (default: "all").
time_filter	string	Time filter: "day", "week", "month", "all" (default: "day").
sort	string	Sort method: "latest", "hot", "most_liked" (default: "latest").
limit	number	Number of results to return (default: 20, max: 100).
skip	number	Number of records to skip for pagination (default: 0).

Optional Parameters (for "detail" action)

Parameter	Type	Description
cognition_id	string	Cognition ID for getting details (required for "detail" action).

Features

1. Cognition Search:

   • Search by keywords
   • Filter by topics
   • Filter by author and source
   • Time-based filtering

2. Sorting Options:

   • Latest cognitions
   • Hot/trending cognitions
   • Most liked cognitions

3. Pagination:

   • Control result count with limit
   • Navigate pages with skip
   • Efficient browsing of large result sets

4. Detailed Information:

   • Get full cognition details by ID
   • Access complete content
   • View metadata and statistics

Usage Examples

List Latest Cognitions

{
  "action": "list",
  "sort": "latest",
  "limit": 10
}

Search Cognitions by Keyword

{
  "action": "list",
  "search": "machine learning",
  "limit": 20
}

Filter by Topics

{
  "action": "list",
  "topics": ["AI", "Deep Learning"],
  "sort": "hot"
}

Filter by Time Period

{
  "action": "list",
  "time_filter": "week",
  "sort": "most_liked",
  "limit": 15
}

Get Cognition Details

{
  "action": "detail",
  "cognition_id": "abc123xyz"
}

Paginated Search

{
  "action": "list",
  "search": "transformer",
  "limit": 20,
  "skip": 20
}

Return Value

For "list" Action

Returns an object containing:

{
  cognitions: [
    {
      id: string;
      title: string;
      abstract: string;
      author: string;
      source: string;
      topics: string[];
      createdAt: string;
      likes: number;
      views: number;
    }
  ],
  total: number;
  hasMore: boolean;
}

For "detail" Action

Returns detailed cognition information:

{
  id: string;
  title: string;
  content: string;
  abstract: string;
  author: string;
  source: string;
  topics: string[];
  createdAt: string;
  updatedAt: string;
  likes: number;
  views: number;
  metadata: object;
}

Error Handling

Possible error scenarios:

1. Authentication Errors:

   • Not authenticated with SII
   • Invalid credentials
   • Expired session

2. Parameter Errors:

   • Invalid action type
   • Missing required parameters
   • Invalid parameter values

3. Network Errors:

   • Connection timeout
   • Service unavailable
   • Network interruption

4. Data Errors:

   • Cognition not found
   • Invalid cognition ID
   • Access denied

Filter Options

Time Filters

• "day": Cognitions from the last 24 hours
• "week": Cognitions from the last 7 days
• "month": Cognitions from the last 30 days
• "all": All cognitions (no time filter)

Sort Methods

• "latest": Most recently created cognitions
• "hot": Trending cognitions based on engagement
• "most_liked": Cognitions with the most likes

Source Filters

Filter cognitions by their source platform or origin (e.g., "arxiv", "reddit", "twitter").

Best Practices

1. Search Optimization:

   • Use specific keywords
   • Combine filters for better results
   • Use topics to narrow down results

2. Pagination:

   • Use reasonable limit values (10-50)
   • Implement pagination for large result sets
   • Track skip value for navigation

3. Performance:

   • Cache frequently accessed cognitions
   • Use time filters to reduce result set
   • Limit result count when appropriate

4. Error Handling:

   • Check authentication before making requests
   • Handle network errors gracefully
   • Validate parameters before submission

Authentication Setup

Setting Environment Variables

Linux/macOS:

export SII_USERNAME="your_username"
export SII_PASSWORD="your_password"

Windows (PowerShell):

$env:SII_USERNAME="your_username"
$env:SII_PASSWORD="your_password"

Notes

1. Authentication Required: This tool requires SII authentication
2. Rate Limiting: May be subject to rate limits
3. Data Freshness: Cognition data is regularly updated
4. Access Control: Some cognitions may have restricted access

Related Tools

• sii_web_search: Search the web using SII
• sii_deep_research: Conduct comprehensive research
• sii_hybrid_search: Combined web and cognition search
• sii_cognition_extract_upload: Extract and upload cognitions