Pi Agent: Extension Basics

بنية الامتداد
├── manifest.yaml    -> البيانات الوصفية (الاسم، الإصدار، التبعيات)
├── tools/          -> تعريفات الأدوات
├── skills/         -> تعريفات المهارات
├── providers/      -> محولات المزوّدين
├── hooks/          -> دوال الخطاف
└── templates/      -> قوالب الأوامر

pi-agent ext install github-tools
pi-agent ext install database-query

pi-agent ext install git+https://github.com/user/pi-ext-custom.git

pi-agent ext install ./my_extension

pi-agent ext list
pi-agent ext update github-tools
pi-agent ext remove github-tools

pi-agent ext create my_extension

name: my_extension
version: "1.0.0"
description: "امتدادي المخصص"
author: "Alice"
min_pi_agent_version: "0.8.0"

dependencies:
  - requests>=2.28.0

tools:
  - tools/my_tool.py

skills:
  - skills/my_skill.yaml

entry_point: hooks.py

# tools/my_tool.py
from pi_agent import tool

@tool(
    name="weather_query",
    description="Query weather for a city",
    parameters={
        "city": {"type": "string", "description": "City name"},
        "unit": {"type": "string", "enum": ["celsius", "fahrenheit"], "default": "celsius"}
    }
)
def weather_query(city: str, unit: str = "celsius") -> dict:
    import requests
    resp = requests.get(f"https://wttr.in/{city}?format=j1")
    data = resp.json()
    temp = data["current_condition"][0]["temp_C"]
    if unit == "fahrenheit":
        temp = int(temp) * 9 // 5 + 32
    return {"city": city, "temperature": temp, "unit": unit}

# hooks.py
from pi_agent import ExtensionHook

class MyExtension(ExtensionHook):
    def on_load(self, agent):
        print(f"Loaded my_extension for {agent.name}")

    def on_tool_call(self, agent, tool_name, params):
        print(f"Tool called: {tool_name}")

    def on_tool_result(self, agent, tool_name, result):
        print(f"Tool result: {tool_name}")

    def on_error(self, agent, error):
        print(f"Error: {error}")

    def on_unload(self, agent):
        print("my_extension unloaded")

pi-agent ext package my_extension
# يُنشئ my_extension-1.0.0.tar.gz

pi-agent ext publish my_extension

cd my_extension
python -m build
twine upload dist/*