Aracılığıyla paylaş

Dizin Bulma

DevUI, dizin yapısından aracıları ve iş akışlarını otomatik olarak bulabilir. Bu, birden çok varlığı düzenlemenizi ve hepsini tek bir komutla başlatmanızı sağlar.

Çok Yakında

C# için DevUI belgeleri yakında kullanıma sunulacaktır. Kavramsal yönergeler için lütfen daha sonra tekrar kontrol edin veya Python belgelerine bakın.

Dizin Yapısı

Aracılarınızın ve iş akışlarınızın DevUI tarafından bulunması için bunların belirli bir dizin yapısında düzenlenmesi gerekir. Her varlığın gerekli değişkeni (__init__.py veya agent) dışarı aktaran bir workflow dosyası olmalıdır.

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

Ajan Örneği

Aracınız için gerekli __init__.py ile bir dizin oluşturun.

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."
)

Temel gereksinim, dosyanın (aracılar için) veya __init__.py (iş akışları için) adlı agent bir değişkeni dışarı aktarması gerektiğidirworkflow.

İş Akışı Örneği

my_workflow/__init__.py:

from agent_framework.workflows import WorkflowBuilder

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

Ortam Değişkenleri

DevUI varsa dosyaları otomatik olarak yükler .env :

  1. Varlık düzeyi .env: Aracı/iş akışı dizinine yerleştirilir ve yalnızca bu varlık için yüklenir
  2. Ana seviyede .env: Tüm varlıklar için yüklenen, varlıkların kök dizinine yerleştirilmiştir

Örnek .env dosya:

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

Tavsiye

Gerçek değerleri göstermeden gerekli ortam değişkenlerini belgeleme amacıyla bir .env.example dosya oluşturun. Gerçek kimlik bilgilerine sahip dosyaları hiçbir zaman kaynak denetimine işlemeyin .env .

Dizin Keşfi ile başlatma

Dizin yapınız ayarlandıktan sonra DevUI'yi başlatın:

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

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

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

DevUI keşfedilen varlık olmadan başladığında, Agent Framework deposundan seçilmiş örnekleri içeren bir örnek galeri görüntüler. Şunları yapabilirsiniz:

  • Kullanılabilir örnek aracılara ve iş akışlarına göz atın
  • Gözden geçirmek ve özelleştirmek için örnekleri indirme
  • Hızlı bir şekilde başlamak için örnekleri yerel olarak çalıştırma

Sorun giderme

Varlık bulunamadı

  • Dosyanın __init__.py, agent veya workflow değişkenini ihraç ettiğinden emin olun.
  • Python dosyalarınızda söz dizimi hatalarını denetleme
  • Dizinin doğrudan iletilen yolun altında olduğunu doğrulayın devui

Ortam değişkenleri yüklenmedi

  • .env Dosyanın doğru konumda olduğundan emin olun
  • Dosya izinlerini denetleme
  • --reload bayrağını geliştirme sırasında yapılan değişiklikleri almak için kullanın.

Sonraki Adımlar

  • Last updated on