> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pawa-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Agents

> Pawa AI lets you create autonomous, task-oriented agents that can reason, act, and interact with users and external tools. These agents can perform complex workflows, automate tasks, and provide intelligent assistance across different domains.

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](/api-reference/endpoint/agents/create?playground=open)

```bash theme={null}
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.