Delen via

Adreslijstdetectie

DevUI kan automatisch agents en werkstromen detecteren vanuit een mapstructuur. Hiermee kunt u meerdere entiteiten organiseren en ze allemaal starten met één opdracht.

Binnenkort beschikbaar

De DevUI-documentatie voor C# is binnenkort beschikbaar. Kom later terug of raadpleeg de Python-documentatie voor conceptuele richtlijnen.

Mapstructuur

Uw agents en werkstromen die door DevUI moeten worden gedetecteerd, moeten worden ingedeeld in een specifieke mapstructuur. Elke entiteit moet een __init__.py bestand hebben waarmee de vereiste variabele (agent of workflow) wordt geëxporteerd.

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

Voorbeeld van agent

Maak een directorie voor uw agent met de vereiste __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."
)

De belangrijkste vereiste is dat het bestand een variabele met de __init__.py naam agent (voor agents) of workflow (voor werkstromen) moet exporteren.

Werkstroomvoorbeeld

my_workflow/__init__.py:

from agent_framework.workflows import WorkflowBuilder

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

Omgevingsvariabelen

DevUI laadt .env automatisch bestanden indien aanwezig:

  1. Entiteitsniveau .env: Geplaatst in de map agent/werkstroom, alleen geladen voor die entiteit
  2. Hoofdniveau .env: Geplaatst in de hoofdmap van de entiteiten, geladen voor alle entiteiten

Voorbeeldbestand .env :

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

Aanbeveling

Maak een .env.example bestand om vereiste omgevingsvariabelen te documenteren zonder werkelijke waarden weer te geven. Nooit bestanden doorvoeren .env met echte referenties voor broncodebeheer.

Starten met Directory Discovery

Zodra uw mapstructuur is ingesteld, start u DevUI:

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

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

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

Wanneer DevUI begint zonder gedetecteerde entiteiten, wordt er een voorbeeldgalerie met gecureerde voorbeelden uit de Agent Framework-opslagplaats weergegeven. U kunt:

  • Door beschikbare voorbeeldagents en werkstromen bladeren
  • Voorbeelden downloaden om te controleren en aan te passen
  • Voorbeelden lokaal uitvoeren om snel aan de slag te gaan

Probleemoplossingsproces

Entiteit niet gedetecteerd

  • Controleren of het __init__.py-bestand de agent- of workflow-variabele exporteert
  • Controleren op syntaxisfouten in uw Python-bestanden
  • Controleer of de directory zich direct onder het pad staat dat is doorgegeven aan devui

Omgevingsvariabelen niet geladen

  • Zorg ervoor dat het .env bestand zich op de juiste locatie bevindt
  • Bestandsmachtigingen controleren
  • Vlag gebruiken --reload om wijzigingen op te halen tijdens de ontwikkeling

Volgende stappen

  • API-naslaginformatie - Meer informatie over de openAI-compatibele API
  • Tracing & Observability - Debuggen van uw agents met traces
  • Last updated on