AgentsSkills

datasphere

View as MarkdownOpen in Claude

Search documents uploaded to SignalWire DataSphere. This skill executes the search via a webhook call from the agent process.

Tools: search_knowledge

Requirements: SignalWire DataSphere credentials

Multi-instance: Yes

space_name
strRequired

SignalWire space name (e.g., "mycompany" from mycompany.signalwire.com).

project_id
strRequired

SignalWire project ID.

token
strRequired

SignalWire API token.

document_id
strRequired

DataSphere document ID to search.

tool_name
strDefaults to search_knowledge

Custom tool name for this instance. Required when using multiple instances.

count
intDefaults to 1

Number of results to return.

distance
floatDefaults to 3.0

Maximum distance threshold for results.

tags
list[str]

Tags to filter search results.

language
str

Language code for query expansion (e.g., "en", "es").

pos_to_expand
list[str]

Parts of speech to expand with synonyms: "NOUN", "VERB", "ADJ", "ADV".

max_synonyms
int

Maximum number of synonyms for query expansion (1–10).

no_results_message
str

Message returned when no results are found. Supports {query} placeholder.

from signalwire import AgentBase
class MyAgent(AgentBase):
    def __init__(self):
        super().__init__(name="assistant", route="/assistant")
        self.set_prompt_text("You are a helpful assistant.")
        self.add_skill("datasphere", {
            "space_name": "your-space",
            "project_id": "YOUR_PROJECT_ID",
            "token": "YOUR_API_TOKEN",
            "document_id": "YOUR_DOCUMENT_ID"
        })
agent = MyAgent()
agent.serve()