Search a document uploaded to SignalWire DataSphere using the RAG stack. The skill issues the search via a webhook call from the agent process.
Credentials (space_name, project_id, token, document_id) are all
required — setup() fails closed if any are missing.
Class: DataSphereSkill
Tools: Custom per instance via tool_name (default search_knowledge)
Env vars: SIGNALWIRE_PROJECT_ID, SIGNALWIRE_TOKEN, SIGNALWIRE_SPACE
Multi-instance: yes
Custom tool name for this DataSphere instance. Required when registering multiple instances on the same agent.
SignalWire space name (e.g., "mycompany" from
mycompany.signalwire.com). Falls back to SIGNALWIRE_SPACE.
SignalWire project ID. Falls back to SIGNALWIRE_PROJECT_ID.
SignalWire API token. Falls back to SIGNALWIRE_TOKEN.
DataSphere document ID to search within.
Number of results to return (range 1-10).
Maximum distance threshold (range 0-10; lower is more relevant).
Tags to filter search results.
Language code for query expansion (e.g., "en", "es").
Parts of speech to expand with synonyms. Each entry must be one of
"NOUN", "VERB", "ADJ", "ADV".
Maximum number of synonyms used for query expansion (range 1-10).
Message returned when no results match the query. Supports a {query}
placeholder that is substituted with the user’s query text.