Kodda iş akışlarını kullanma

Tamamlandı

Microsoft Foundry görsel tasarımcısında bir iş akışı tasarladıktan ve test ettikten sonra Azure AI Projeleri SDK'sını kullanarak iş akışını uygulamalarınızla tümleştirebilirsiniz. Bu, iş akışı temelli otomasyonu web uygulamalarına, API'lere, arka uç hizmetlerine ve diğer yazılım çözümlerine eklemenizi sağlar.

İş akışları, temel alınan YAML tanımını oluşturan görsel tasarımcı kullanılarak Döküm portalında oluşturulur. Projenize bir iş akışı kaydedildikten sonra, adına başvurarak program aracılığıyla çağırabilirsiniz. Ayrıca iş akışının YAML tanımını portaldan indirebilir ve kod tabanınıza ekleyebilirsiniz.

İş akışı çağırma

Bir iş akışı çalıştırmadan önce, AIProjectClient kullanarak Microsoft Foundry projenize bağlantı kurun. Bu istemci kimlik doğrulamasını işler ve konuşmaları yürütmek ve iş akışlarını çağırmak için OpenAI uyumlu API'ye erişim sağlar. Projenizde var olan bir iş akışını çalıştırmak için bir konuşma oluşturun ve iş akışını ada göre çağırın.

# Reference a workflow created in the Foundry portal
workflow_name = "triage-workflow"

# Create a conversation context for the workflow
conversation = openai_client.conversations.create()

# Execute the workflow, passing input to drive the workflow logic
stream = openai_client.responses.create(
    conversation=conversation.id,
    extra_body={"agent": {"name": workflow_name, "type": "agent_reference"}},
    input="Users can't reset their password from the mobile app.",
    stream=True,
)

input parametresi, iş akışının kullanıcı isteğini işleme, destek biletini önceliklendirme veya bir soruyu yanıtlama gibi mantığını yönlendirmek için kullanabileceği bir istem veya ileti iletmenizi sağlar. İş akışınızın nasıl tasarlandığına bağlı olarak, bu giriş şu şekilde olabilir:

• Aracıların çözümleyip yanıt verdiği bir kullanıcı sorusu
• Sınıflandırma ve yönlendirme için destek bileti açıklaması
• İşleme mantığını tetikleyen veri yükü
• Yalnızca belirli bir giriş olmadan iş akışını başlatan boş bir dize

İş akışı olaylarını işleme

Streaming etkinleştirildiğinde, iş akışı yürütülürken uygulamanız olayları alır. Bu olaylar gerçek zamanlı ilerleme durumunu görüntülemenize, aracı çıkışlarını yakalamanıza ve iş akışı eylemlerine yanıt vermenizi sağlar.

for event in stream:
    if event.type == "response.completed":
        print("Workflow completed:")
        for message in event.response.output:
            if message.content:
                for content_item in message.content:
                    if content_item.type == 'output_text':
                        print(content_item.text)
    if (event.type == "response.output_item.done") and event.item.type == ItemType.WORKFLOW_ACTION:
        print(f"Action '{event.item.action_id}' completed with status: {event.item.status}")

Yaygın olay türleri şunlardır:

Olay Türü	Description
response.completed	İş akışı yürütmeyi tamamladı ve son yanıtı döndürdü
response.output_item.done	Tek bir çıkış öğesi (iş akışı eylemi gibi) tamamlandı

Bu olayları izleyerek, iş akışının gerçek zamanlı olarak nasıl ilerlediğini görebilir veya iş akışı durumuna göre dış eylemleri tetikleyebilirsiniz. Alternatif olarak, iş akışının tamamının tamamlanmasını beklemeyi ve son yanıtı akış olmadan işlemeyi seçebilirsiniz. Döngüdeki insan desenlerini içeren iş akışları için uygulamanızın iş akışının kullanıcı girişini beklediği duraklamaları işlemesi gerekebilir. Böyle durumlarda, istenen girişi sağlamak ve iş akışı yürütmeyi sürdürmek için konuşmaya ek iletiler gönderebilirsiniz.

Kod tümleştirmesinin avantajları

İş akışlarını kodunuzla tümleştirmek birkaç senaryoya olanak tanır:

Scenario	Fayda
Web uygulamaları	Yapay zeka temelli iş akışlarını doğrudan kullanıcıya yönelik uygulamalara ekleme
API'ler ve mikro hizmetler	REST uç noktaları aracılığıyla iş akışı özelliklerini kullanıma sunma
Toplu işleme	Toplu işlemler için program aracılığıyla iş akışlarını çağırma
Sınama ve doğrulama	CI/CD işlem hatlarının bir parçası olarak iş akışı testini otomatikleştirme
Özel arabirimler	Belirli iş akışı kullanım örneklerine göre uyarlanmış özel Kullanıcı Arayüzleri oluşturun

Foundry portalının görsel tasarım deneyimini kod tümleştirme esnekliğiyle birleştirerek, mevcut yazılım mimarinize sorunsuz bir şekilde uyan güçlü yapay zeka temelli çözümler oluşturabilirsiniz.