Analizowanie ustrukturyzowanych danych przy użyciu interpretera kodu (wersja zapoznawcza)

[Ten artykuł stanowi wstępne wydanie dokumentacji i może ulec zmianie.]

Korzystając z interpretera kodu, agenci Copilot Studio mogą tworzyć oraz uruchamiać kod w Python, gdy muszą odpowiedzieć na polecenia użytkownika. Interpreter kodu obsługuje zadania takie jak analiza statystyczna, łączenie tabel, prognozowanie oraz generowanie wykresów. Te zadania są wykonywane na ustrukturyzowanych plikach, takich jak CSV i Excel.

Ważne

Ten artykuł zawiera dokumentację usługi Microsoft Copilot Studio w wersji zapoznawczej i może ulec zmianie.

Funkcje w wersji zapoznawczej nie są przeznaczone do użytku w środowiskach produkcyjnych i mogą mieć ograniczoną funkcjonalność. Te funkcje są udostępniane przed oficjalnym wydaniem, dzięki czemu można szybciej uzyskać do nich dostęp i przekazać opinie na ich temat.

Jeśli kompilowany jest agent gotowy do użycia w środowiskach produkcyjnych, zobacz temat Omówienie usługi Microsoft Copilot Studio (produkcja).

Korzyści płynące z użycia interpretera kodu do analizy plików danych strukturalnych:

• Korzystając z deterministycznych, powtarzalnych obliczeń, możesz odblokować wiarygodną analizę w agentach zamiast polegać na wbudowanych możliwościach matematycznych i wnioskowania dużych modeli językowych do odpowiadania na pytania analityczne.
• Zmniejsz wymagania dotyczące umiejętności w zaawansowanej analityce, pozwalając użytkownikom zadawać pytania analityczne w języku naturalnym.
• Generuj tabele i wizualizacje wyników programowo, które użytkownicy mogą zobaczyć, pobrać i ponownie wykorzystać.

Agenci Copilot Studio mogą używać interpretera kodu do analizy plików strukturalnych udostępnianych agentowi na dwa sposoby:

• Jako użytkownik końcowy, gdy przesyłasz uporządkowane pliki podczas rozmowy z agentem.
• Jako twórca, kiedy dodajesz bibliotekę SharePoint Dokumenty SharePoint jako źródło wiedzy, zawierającą pliki ustrukturyzowane.

Wymagania wstępne

• Licencjonowanie: Rozliczenia i licencjonowanie programu Microsoft Copilot Studio. Generowanie kodu i liczba wykonań zaliczają się do funkcji tekst i generatywne narzędzia AI (premium).

• Obsługiwane regiony: dostępne dla wszystkich chmur publicznych. Chmury suwerenne nie są obecnie obsługiwane.

Scenariusze szeroko testowane

Firma Microsoft przetestowała następujące scenariusze w szerokim zakresie, z wysokim poziomem pewności.

Notatka

• Jeśli twój scenariusz nie znajduje się wśród wymienionych w tabelach, może mimo to działać. Scenariusze wymienione w poniższych tabelach odzwierciedlają grupę scenariuszy, które Microsoft przetestował w szerokim zakresie na podstawie przewidywanego zastosowania przez klientów.
• Maksymalny rozmiar pliku analizowanego przez interpreter kodu, niezależnie od typu pliku, wynosi 16 MB. Możesz przesłać maksymalnie 10 plików.

Scenariusze dla plików Excel w formacie .xlsx

Kategoria	Opis scenariusza	Przykład 1	Przykład 2	Przykład 3
Wyszukiwanie – pojedynczy arkusz	Pobierz konkretną wartość, etykietę lub rekord z pojedynczego arkusza pliku Excel. Nie są wymagane obliczenia między wierszami. Odpowiedzią jest bezpośrednie wyszukiwanie komórki/wiersza. Obejmuje wartości numeryczne, atrybuty tekstowe (nazwy, role, kategorie) oraz sygnatury czasowe.	Które urządzenia zawierają boczne siatki umożliwiające przyjęcie co najmniej trzech goli?	Ile wynosił wolny przepływ gotówki w IV kwartale 2024 roku?	Do jakiego segmentu należą hurtowe dostawy paliw od pierwszego kwartału 2024 roku?

Scenariusze dla plików .csv

Kategoria	Opis scenariusza	Przykład 1	Przykład 2	Przykład 3
Wyszukiwanie - pojedynczy plik	Pobierz określoną wartość, atrybut lub rekord z pojedynczego pliku CSV. Obejmuje wyszukiwanie encji (kontakty, lotniska, projekty farm wiatrowych), odczyt wartości w określonym czasie oraz wyszukiwanie w małych tabelach. Nie jest wymagana agregacja między wierszami.	Kto jest deweloperem projektu Sunrise Wind?	Ile motocykli zostało zarejestrowanych w Tennessee w 1970 roku?	Kto jest właścicielem lotniska Horseshoe Landings w Keenesburg, w stanie Kolorado?
Agregacja – pojedynczy plik	Obliczaj sumy, liczności, różnice, podsumowania grupowane lub rankingowe wyszukiwania w jednym pliku CSV. Obejmuje agregacje finansowe, warunkowe zliczenia, sklasyfikowane pobieranie (maks./min.) oraz podsumowania na poziomie grupy, zwracane w postaci liczb, tekstu lub tabel.	Jaka była łączna wartość opłat licencyjnych ze sprzedaży ropy naftowej wydobywanej na lądzie w 2019 roku?	O ile więcej ciężarówek zarejestrowano w Kalifornii w 2020 roku niż w 2010?	Jaki jest łączny przychód ze sprzedaży uzyskany przez każdy region w styczniu 2025 r?
Wyszukiwanie – wiele plików	Połącz lub zestawiaj wiele plików CSV, aby uzyskać konkretną wartość lub listę (na przykład wyszukując stan magazynowy przez dopasowanie nazw części między listą części, zapasami i cennikiem; lub zapytując dane emisji przez zestawienie nazw sektorów z głównym plikiem emisji).	Ile wycinarek wodnych jest dostępnych w magazynie East?	Jaka jest cena edukacyjna tokarki 10x24?	Ile wierteł 3/8" znajduje się na stanie w magazynie East?
Agregacja – wiele plików	Agreguj lub porównaj dane rozproszone w wielu plikach CSV (na przykład sumuj godziny pracy pracowników w miesięcznych CSV w celu kwartalnego sumowania, licząc transakcje z rocznego eksportu w pliku CSV lub klasyfikując sektory według emisji w połączonych plikach).	Ile łącznie godzin pracy zostało zarejestrowanych w trzecim kwartale?	O której godzinie najwcześniej Chris rozpoczął pracę w lipcu?	Który sektor wyprodukował najwięcej CO2 w 2020 roku?

Użycie interpretera kodu do analizy pliku danych strukturalnych przesłanego przez użytkownika

1. W Copilot Studio wybierz Ustawienia>Generatywna AI. W sekcji Możliwości przetwarzania plików włącz Przełącznik przesyłania plików.

2. W obszarze Możliwości przetwarzania plików włącz Interpreter kodu.

3. Wybierz pozycję Zapisz.

4. W panelu testowym napisz zapytanie, które wymaga od agenta wykonania obliczenia wykorzystującego dane z pliku danych strukturalnych. Dołącz plik danych do polecenia.

   

Użyj interpretera kodu do analizy pliku danych strukturalnych jako źródła wiedzy SharePoint

1. Jeśli Twój agent nie ma jeszcze pliku danych strukturalnych SharePoint jako źródła wiedzy, dodaj ten plik SharePoint jako źródło wiedzy.

2. W Copilot Studio wybierz Ustawienia>Generatywna AI. W obszarze Możliwości przetwarzania plików włącz Interpreter kodu.

3. W obszarze Wyszukiwanie wybierz Włącz Work IQ.

4. Wybierz pozycję Zapisz.

5. Jeżeli poproszono o dodanie pliku SharePoint zgodnie z instrukcjami w pierwszym kroku, opublikuj swojego agenta.

6. Przetestuj swojego agenta, zadając mu zapytanie, które wymaga od niego wykonania obliczeń, aby odpowiedzieć.