Skip to main content
Pawa AI agents are autonomous, task-oriented systems designed to perform actions, reason about problems, and interact with users or external tools. They can execute complex workflows, respond to dynamic inputs, and make decisions based on their built-in capabilities.

​
Creating an Agent with Pawa AI

To create an agent, you typically define:
  1. Name and Description
    A clear name and concise description help identify the agent’s purpose.
  2. Instructions
    Specific rules or guidance for how the agent should behave.
  3. Intents and Capabilities
    Optionally define what the agent is capable of doing — for example, answering questions, performing calculations, or interacting with external systems.
  4. Tools and Integrations
    Optionally list external tools the agent can use to perform its tasks. You can put custom or built-in tools
  5. Knowledge Base ID as References
    Optionally if the agent needs access to a knowledge base, provide references or IDs to the relevant data sources.

​
Create Agent Request

You can create a Pawa AI agent by sending a POST request to the API endpoint. Below is an example: You can quickly test this endpoint in the API reference: Try it in the API Reference 
curl -X POST "https://api.pawa.ai/agents" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer PAWA_AI_API_KEY" \
  -d '{
  "name": "TutorAI",
  "description": "TutorAI is an AI agent designed to assist students with their studies.",
  "instruction": "Teaching students on subjects ranging from form 0ne to form 4. Follow questions properly and do not answer any other questions apart from what you have been tasked to",
  "intents": [
    "Be gentle",
    "Be detailed"
  ],
  "knowledgeBaseId": 159,
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "convert_usd_to_tsh",
        "description": "Converts an amount in USD to Tanzanian Shillings.",
        "strict": true,
        "parameters": {
          "type": "object",
          "properties": {
            "amount_usd": {
              "description": "Amount in USD",
              "type": "number"
            }
          },
          "required": [
            "amount_usd"
          ],
          "additionalProperties": false
        }
      }
    },
    {
      "type": "pawa_tool",
      "pawa_tool": "web_search_tool"
    }
  ]
}'
You can create multiple agents, based on your tier plan, and use the orchestration conversation to chat, and the Pawa AI will dynamically decide what agent(s) to use, contribute, etc.
⌘I