Sdílet prostřednictvím

Zjišťování adresářů

DevUI může automaticky zjišťovat agenty a pracovní postupy z adresářové struktury. To vám umožní uspořádat více entit a spustit je všechny jedním příkazem.

Již brzy

Dokumentace k DevUI pro C# bude brzy k dispozici. Zkontrolujte to prosím později nebo se obraťte na dokumentaci k Pythonu pro konceptuální pokyny.

Adresářová struktura

Aby bylo možné agenty a pracovní postupy zjistit pomocí DevUI, musí být uspořádány do konkrétní adresářové struktury. Každá entita musí mít __init__.py soubor, který exportuje požadovanou proměnnou (agent nebo workflow).

entities/
    weather_agent/
        __init__.py      # Must export: agent = Agent(...)
        agent.py         # Agent implementation (optional, can be in __init__.py)
        .env             # Optional: API keys, config vars
    my_workflow/
        __init__.py      # Must export: workflow = WorkflowBuilder(start_executor=...)...
        workflow.py      # Workflow implementation (optional)
        .env             # Optional: environment variables
    .env                 # Optional: shared environment variables

Příklad agenta

Vytvořte adresář pro vašeho agenta s požadovaným kódem __init__.py:

weather_agent/__init__.py:

from agent_framework import Agent
from agent_framework.openai import OpenAIChatClient

def get_weather(location: str) -> str:
    """Get weather for a location."""
    return f"Weather in {location}: 72F and sunny"

agent = Agent(
    name="weather_agent",
    chat_client=OpenAIChatClient(),
    tools=[get_weather],
    instructions="You are a helpful weather assistant."
)

Klíčovým požadavkem je, aby __init__.py soubor musel exportovat proměnnou s názvem agent (pro agenty) nebo workflow (pro pracovní postupy).

Příklad pracovního postupu

my_workflow/__init__.py:

from agent_framework.workflows import WorkflowBuilder

workflow = (
    WorkflowBuilder(start_executor="my_executor")
    .add_executor(...)
    .add_edge(...)
    .build()
)

Proměnné prostředí

DevUI automaticky načte .env soubory, pokud jsou k dispozici:

  1. Úroveň .enventity: Umístěna v adresáři agenta/pracovního postupu, načtena pouze pro danou entitu
  2. Nadřazená úroveň .env: Umístěno do kořenového adresáře entit, načteno pro všechny entity

Příklad .env souboru:

OPENAI_API_KEY=sk-...
AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com/

Návod

Vytvořte .env.example soubor pro dokumentaci požadovaných proměnných prostředí bez vystavení skutečných hodnot. Nikdy nepokládejte .env soubory se skutečnými přihlašovacími údaji ke správě zdrojového kódu.

Spuštění pomocí zjišťování adresářů

Po nastavení adresářové struktury spusťte DevUI:

# Discover all entities in ./entities directory
devui ./entities

# With custom port
devui ./entities --port 9000

# With auto-reload for development
devui ./entities --reload

Když DevUI začíná bez zjištěných entit, zobrazí ukázkovou galerii s kurátorovanými příklady z úložiště Agent Framework. Můžete:

  • Procházet dostupné ukázkové agenty a pracovní postupy
  • Stažení ukázek pro kontrolu a přizpůsobení
  • Spusťte vzorky lokálně pro rychlý začátek

Řešení problémů

Entita nebyla zjištěna.

  • Ujistěte se, že soubor __init__.py exportuje buď proměnnou agent, nebo workflow.
  • Kontrola chyb syntaxe v souborech Pythonu
  • Ověřte, že je adresář přímo pod cestou předanou do devui

Proměnné prostředí nejsou načteny

  • Ujistěte se, že .env je soubor ve správném umístění.
  • Kontrola oprávnění k souborům
  • Použijte --reload příznak pro zachycení změn během vývoje

Další kroky

  • Last updated on