Field Control

Use this when the user asks about a specific service type by ID. Returns complete service data including name, description, pricing and configuration. Do not use for listing multiple services — use search_services instead.

Use this when the user asks about a specific storage location or warehouse by ID. Returns complete storage data including name, address and inventory summary. Do not use for listing multiple storages — use search_storages instead.

Use this when the user asks about a specific task by ID. Returns complete task data including description, status, scheduled date, duration, assigned employee, order reference and checklist items. Do not use for listing multiple tasks — use search_tasks instead.

Use this when the user asks about a specific support ticket by ID. Returns complete ticket data including subject, description, status, priority, requester, assigned employee and conversation history. Do not use for listing multiple tickets — use search_tickets instead.

Use this when the user asks about a specific system user by ID. Returns complete user data including name, email, role, phone and profile settings. Do not use for listing multiple users — use search_users instead.

Use this when you need to discover available types, fields and operations in the data model. Introspects the GraphQL schema structure.

Use this when the user wants to see notes or comments left on a specific work order. Requires an order ID. Returns paginated results with comment text, author and date. Do not use for general order info — use get_order_details instead.

Use this when the user wants to find, list or search customers (clientes). Returns paginated results with customer name, document number, contact info and address. Supports filtering by name, city, state, document number, tags and rating. Do not use for getting details of a single customer — use get_customer_details instead.

Use this when the user wants to list, search or filter field technicians/employees (técnicos/funcionários). Returns paginated results with employee name, email, groups and contract status. Supports filtering by name, active status, group and territory. Do not use for getting details of a single employee — use get_employee_details instead.

Use this when the user wants to find, list or search equipments (equipamentos). Returns paginated results with equipment name, serial number, model, customer and location. Supports filtering by name, serial number, customer and location. Do not use for getting details of a single equipment — use get_equipment_details instead.

Use this when the user wants to find, list or search service locations (locais de atendimento). Returns paginated results with location name, address, customer and contact info. Supports filtering by name, city, state, customer and territory. Do not use for getting details of a single location — use get_location_details instead.

Use this when the user wants to see which equipments were serviced in work orders. Returns paginated results with equipment name, order reference and service details.

Use this when the user wants to see which parts were consumed in field service orders. Returns paginated results with part name, quantity, order reference and technician.

Use this when the user wants to list, search or filter work orders (ordens de serviço). Returns paginated results with order ID, identifier, status, customer name, scheduled date and assigned employee. Supports filtering by date range, status, customer, employee and territory. Do not use for getting details of a single order — use get_order_details instead.

Use this when the user wants to see part categories or types. Returns list of part types with name and description.

Use this when the user wants to list individual serialized part units. Returns paginated results with unit serial number, status and location. Supports filtering by part and status. Do not use for getting details of a single unit — use get_part_unit_details instead.

Use this when the user wants to find or list inventory parts (peças). Returns paginated results with part name, code, quantity and unit price. Supports filtering by name and code. Do not use for getting details of a single part — use get_part_details instead.

Use this when the user wants to see product categories or types. Returns list of product types with name and description.

Use this when the user wants to find or list products (produtos). Returns paginated results with product name, code and price. Supports filtering by name and type. Do not use for getting details of a single product — use get_product_details instead.

Use this when the user wants to list, search or filter quotations/estimates (orçamentos). Returns paginated results with quotation number, customer, total value, status and date. Supports filtering by status, customer and date range. Do not use for getting details of a single quotation — use get_quotation_details instead.

Use this when looking for specific data fields or entities in the schema. Searches for types or fields matching a keyword.

Use this when the user wants to list or search service types (tipos de serviço). Returns paginated results with service name, description and pricing. Supports filtering by name. Do not use for getting details of a single service — use get_service_details instead.

Use this when the user wants to check inventory items in a specific warehouse. Returns paginated results with item name, quantity and location within storage.

Use this when the user wants to track inventory movements or stock changes (movimentações de estoque). Returns paginated results with movement type, item, quantity, date and responsible person.

Use this when the user wants to check part stock levels in a specific storage. Returns paginated results with part name, quantity available and storage location.

Use this when the user wants to check product stock levels in a specific storage. Returns paginated results with product name, quantity available and storage location.

Use this when the user wants to see pending inventory requests from field technicians (requisições de estoque). Returns paginated results with request status, items requested and requester.

Use this when the user wants to list storage locations or warehouses (almoxarifados). Returns paginated results with storage name and address. Do not use for getting details of a single storage — use get_storage_details instead.

Use this when the user wants to list, search or filter tasks (atividades/tarefas). Returns paginated results with task ID, description, status, scheduled date, duration and assigned employee. Supports filtering by date range, status, employee and order. Do not use for getting details of a single task — use get_task_details instead.

Use this when the user wants to list, search or filter support tickets (chamados). Returns paginated results with ticket subject, status, priority, requester and creation date. Supports filtering by status, priority, requester and date range. Do not use for getting details of a single ticket — use get_ticket_details instead.

Use this when the user wants to list or search system users who have access to the account. Returns paginated results with user name, email and role. Supports filtering by name and email. Do not use for getting details of a single user — use get_user_details instead.

Use this when the user wants to list work services performed on orders (serviços executados). Returns paginated results with service name, quantity and value.

Use this when you need to check if a GraphQL query is syntactically correct before executing it. Validates a query against the schema without running it.