Create Agents

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:

Name and Description
A clear name and concise description help identify the agent’s purpose.
Instructions
Specific rules or guidance for how the agent should behave.
Intents and Capabilities
Optionally define what the agent is capable of doing — for example, answering questions, performing calculations, or interacting with external systems.
Tools and Integrations
Optionally list external tools the agent can use to perform its tasks. You can put custom or built-in tools
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.

Getting Started

Learn More

Capabilities

Agents

Going Production

Guides

Resources

Creating an Agent with Pawa AI

Create Agent Request

​Creating an Agent with Pawa AI

​Create Agent Request

Creating an Agent with Pawa AI

Create Agent Request