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

# Agno

> Bangun agen otonom multimodal, sistem multi-agent, dan eksekusi tools dengan Agno.

[Agno](https://www.agno.com/?utm_source=neosantara-docs\&utm_medium=referral) adalah framework open-source untuk membangun agen otonom, sistem multi-agent, dan aplikasi multimodal. Neosantara hadir sebagai provider resmi melalui kelas `agno.models.neosantara.Neosantara` dengan dukungan tool calling, persistent memory, dan inferensi multimodal.

## Instalasi

Pasang Agno dan library pendukung:

```bash theme={"theme":{"light":"ayu-dark","dark":"catppuccin-latte"}}
pip install -U agno ddgs
```

## Autentikasi

Setel API key Neosantara di environment:

```bash theme={"theme":{"light":"ayu-dark","dark":"catppuccin-latte"}}
export NEOSANTARA_API_KEY="nsk_..."
```

Provider native Agno secara otomatis mengarahkan panggilan ke `https://api.neosantara.xyz/v1`.

## Agen Native Pertama

<CodeGroup>
  ```python Python (Basic Agent) icon="python" theme={"theme":{"light":"ayu-dark","dark":"catppuccin-latte"}}
  from agno.agent import Agent
  from agno.models.neosantara import Neosantara

  agent = Agent(
      model=Neosantara(id="claude-opus-4-6"),
      markdown=True
  )

  agent.print_response("Jelaskan peran gateway AI dalam 2 kalimat.")
  ```

  ```python Python (Streaming Output) icon="python" theme={"theme":{"light":"ayu-dark","dark":"catppuccin-latte"}}
  from agno.agent import Agent
  from agno.models.neosantara import Neosantara

  agent = Agent(
      model=Neosantara(id="gemini-3.8-flash"),
      markdown=True
  )

  agent.print_response(
      "Buat checklist penanganan insiden sistem terdistribusi.",
      stream=True
  )
  ```
</CodeGroup>

## Agen dengan Tool Calling (Search)

Gabungkan model native Neosantara dengan alat pencarian web:

```python theme={"theme":{"light":"ayu-dark","dark":"catppuccin-latte"}}
from agno.agent import Agent
from agno.models.neosantara import Neosantara
from agno.tools.duckduckgo import DuckDuckGoTools

agent = Agent(
    model=Neosantara(id="gemini-3.8-flash"),
    tools=[DuckDuckGoTools()],
    instructions="Selalu sertakan sumber rujukan terverifikasi.",
    markdown=True
)

agent.print_response("Berapa valuasi pasar startup AI di Asia Tenggara tahun 2026?")
```

## Keunggulan Integrasi Agno

| Fitur                           | Pendekatan Wrapper Generik                  | Provider Resmi Neosantara                         |
| :------------------------------ | :------------------------------------------ | :------------------------------------------------ |
| **Impor Modul**                 | `from agno.models.openai import OpenAIChat` | `from agno.models.neosantara import Neosantara`   |
| **Tool Calling & Agent Memory** | Bergantung pada adapter pihak ketiga        | Terintegrasi langsung dengan struktur native Agno |
| **Dukungan Model**              | Terbatas pada konfigurasi manual            | Mendukung seluruh katalog model Neosantara        |
| **Streaming & Markdown**        | Parsing respons manual                      | Format output markdown dan streaming bawaan       |


## Related topics

- [Ringkasan Integrasi](/id/integrations/overview.md)
- [CrewAI](/id/integrations/crewai.md)
- [Arsitektur MCP & Agen](/id/agents/overview.md)
- [Katalog Model](/id/gateway/models.md)