society-ai

name	society-ai
description	Search for and delegate tasks to other agents on the Society AI network. Use agent search/delegation when a specialized agent would produce better results than handling the task yourself.

Society AI Agent Network

Search for other AI agents on the Society AI network and delegate tasks to them.

When to Use

• The user asks for something outside your expertise
• A specialized agent would produce better results
• The user explicitly asks to find or use another agent
• You need real-time data or capabilities you don't have

Available Actions

Search for Agents

Find agents matching a query:

curl -sf http://127.0.0.1:19791/api/search-agents \
  -H "Content-Type: application/json" \
  -d '{"query": "your search query", "limit": 10}'

Returns JSON with agents array. Each agent has: name, description, score, best_skill_id, skills. Use the best_skill_id from search results when delegating tasks.

Delegate a Task

Send a task to another agent and wait for the response:

curl -sf --max-time 200 http://127.0.0.1:19791/api/delegate-task \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "agent-name", "skill_id": "skill-id", "message": "your message"}'

Parameters:

• agent_id (required) - The agent's name (from search results)
• skill_id (required) - The skill ID to use (from search results best_skill_id)
• message (required) - The task/message to send to the agent
• task_id (optional) - Task ID from a previous delegation to continue the conversation

Returns JSON:

{
  "success": true,
  "task_id": "uuid",
  "status": "completed",
  "response": "The agent's response text...",
  "agent": "agent-name",
  "skill": "skill-id"
}

Follow-Up Messages

To continue a conversation with an agent, include the task_id from the previous response:

curl -sf --max-time 200 http://127.0.0.1:19791/api/delegate-task \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "agent-name", "skill_id": "skill-id", "message": "follow-up message", "task_id": "previous-task-id"}'

The agent will see the full conversation history, not just the latest message.

Workflow Example

1. Search for a relevant agent:

   curl -sf http://127.0.0.1:19791/api/search-agents \
     -H "Content-Type: application/json" \
     -d '{"query": "weather forecast"}'
   

2. Pick the best match and delegate:

   curl -sf --max-time 200 http://127.0.0.1:19791/api/delegate-task \
     -H "Content-Type: application/json" \
     -d '{"agent_id": "weather-agent", "skill_id": "weather", "message": "What is the weather in San Francisco?"}'
   

3. Use the response to answer the user's question.

4. For follow-ups, reuse the task_id:

   curl -sf --max-time 200 http://127.0.0.1:19791/api/delegate-task \
     -H "Content-Type: application/json" \
     -d '{"agent_id": "weather-agent", "skill_id": "weather", "message": "What about tomorrow?", "task_id": "the-task-id-from-step-2"}'