Udostępnij przez

DevUI — przykładowa aplikacja do uruchamiania agentów i przepływów pracy

DevUI to uproszczona, autonomiczna przykładowa aplikacja do uruchamiania agentów i przepływów pracy w programie Microsoft Agent Framework. Udostępnia interfejs internetowy do testowania interaktywnego wraz z zapleczem interfejsu API zgodnym z interfejsem OpenAI, co umożliwia wizualne debugowanie, testowanie i iterowanie agentów i przepływów pracy, które tworzysz przed zintegrowaniem ich z aplikacjami.

Ważne

DevUI to przykładowa aplikacja , która ułatwia wizualizowanie i debugowanie agentów i przepływów pracy podczas programowania. Nie jest przeznaczony do użytku produkcyjnego.

Wkrótce

Dokumentacja usługi DevUI dla języka C# jest dostępna wkrótce. Sprawdź ponownie później lub przejrzyj dokumentację języka Python, aby uzyskać wskazówki koncepcyjne.

Panel kontrolny devUI Agent Framework pokazujący katalog agentów i śledzenie

Funkcje

  • Interfejs internetowy: interaktywny interfejs użytkownika do testowania agentów i przepływów pracy
  • Elastyczne typy danych wejściowych: obsługa tekstu, przekazywania plików i niestandardowych typów danych wejściowych na podstawie pierwszego wykonawcy przepływu pracy
  • Odnajdywanie Oparte na Katalogu: automatyczne odnajdywanie agentów i przepływów pracy ze struktury katalogów
  • Rejestracja In-Memory: programowe rejestrowanie elementów bez konfiguracji systemu plików
  • Interfejs API kompatybilny z OpenAI: używanie zestawu SDK języka Python OpenAI do interakcji z agentami
  • Przykładowa galeria: przeglądanie i pobieranie wyselekcjonowanych przykładów, gdy nie odnaleziono żadnych jednostek
  • Śledzenie: Wyświetlanie śladów OpenTelemetry na potrzeby debugowania i obserwowania

Typy danych wejściowych

Usługa DevUI dostosowuje interfejs wejściowy na podstawie typu jednostki:

  • Agenci: obsługują załączniki tekstu i plików (obrazy, dokumenty itp.) na potrzeby interakcji wielomodalnych
  • Przepływy pracy: interfejs wejściowy jest generowany automatycznie na podstawie typu danych wejściowych pierwszego wykonawcy. DevUI wykonuje introspekcję przepływów pracy i odzwierciedla oczekiwany schemat wejściowy, co upraszcza testowanie za pomocą uporządkowanych lub niestandardowych typów danych wejściowych.

Ta dynamiczna obsługa danych wejściowych umożliwia testowanie agentów i przepływów pracy dokładnie tak, jak będą odbierać dane wejściowe w aplikacji.

Instalacja

Zainstaluj DevUI z PyPI.

pip install agent-framework-devui --pre

Szybki start

Opcja 1. Rejestracja programowa

Uruchom interfejs DevUI z agentami zarejestrowanymi w pamięci:

from agent_framework import Agent
from agent_framework.openai import OpenAIChatClient
from agent_framework.devui import serve

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

# Create your agent
agent = Agent(
    name="WeatherAgent",
    chat_client=OpenAIChatClient(),
    tools=[get_weather]
)

# Launch DevUI
serve(entities=[agent], auto_open=True)
# Opens browser to http://localhost:8080

Opcja 2: Wykrywanie katalogów (CLI)

Jeśli masz agentów i przepływy pracy zorganizowane w strukturze katalogów, uruchom narzędzie DevUI z poziomu wiersza polecenia:

# Launch web UI + API server
devui ./agents --port 8080
# Web UI: http://localhost:8080
# API: http://localhost:8080/v1/*

Aby uzyskać szczegółowe informacje na temat wymaganej struktury katalogów, zobacz Odnajdywanie katalogów .

Korzystanie z zestawu OpenAI SDK

Interfejs DevUI udostępnia interfejs API odpowiedzi zgodny z interfejsem OpenAI. Zestaw SDK języka Python openAI umożliwia interakcję z agentami:

from openai import OpenAI

client = OpenAI(
    base_url="http://localhost:8080/v1",
    api_key="not-needed"  # API key not required for local DevUI
)

response = client.responses.create(
    metadata={"entity_id": "weather_agent"},  # Your agent/workflow name
    input="What's the weather in Seattle?"
)

# Extract text from response
print(response.output[0].content[0].text)

Aby uzyskać więcej informacji na temat interfejsu API, zobacz Dokumentacja interfejsu API.

Opcje CLI

devui [directory] [options]

Options:
  --port, -p      Port (default: 8080)
  --host          Host (default: 127.0.0.1)
  --headless      API only, no UI
  --no-open       Don't automatically open browser
  --tracing       Enable OpenTelemetry tracing
  --reload        Enable auto-reload
  --mode          developer|user (default: developer)
  --auth          Enable Bearer token authentication
  --auth-token    Custom authentication token

Dalsze kroki

  • Last updated on