@@ -187,7 +187,7 @@ <h3>Inherited members</h3>
187187</ dd >
188188< dt id ="slack_sdk.models.blocks.block_elements.ButtonElement "> < code class ="flex name class ">
189189< span > class < span class ="ident "> ButtonElement</ span > </ span >
190- < span > (</ span > < span > *,< br > text: str | dict | < a title ="slack_sdk.models.blocks.basic_components.TextObject " href ="basic_components.html#slack_sdk.models.blocks.basic_components.TextObject "> TextObject</ a > ,< br > action_id: str | None = None,< br > url: str | None = None,< br > value: str | None = None,< br > style: str | None = None,< br > confirm: dict | < a title ="slack_sdk.models.blocks.basic_components.ConfirmObject " href ="basic_components.html#slack_sdk.models.blocks.basic_components.ConfirmObject "> ConfirmObject</ a > | None = None,< br > accessibility_label: str | None = None,< br > **others: dict)</ span >
190+ < span > (</ span > < span > *,< br > text: str | dict | < a title ="slack_sdk.models.blocks.basic_components.TextObject " href ="basic_components.html#slack_sdk.models.blocks.basic_components.TextObject "> TextObject</ a > ,< br > action_id: str | None = None,< br > url: str | None = None,< br > value: str | None = None,< br > style: str | None = None,< br > confirm: dict | < a title ="slack_sdk.models.blocks.basic_components.ConfirmObject " href ="basic_components.html#slack_sdk.models.blocks.basic_components.ConfirmObject "> ConfirmObject</ a > | None = None,< br > accessibility_label: str | None = None,< br > agent_prompt: str | None = None, < br > agent_prompt_display: str | None = None, < br > visible_to_user_ids: List[str] | None = None, < br > **others: dict)</ span >
191191</ code > </ dt >
192192< dd >
193193< details class ="source ">
@@ -199,10 +199,23 @@ <h3>Inherited members</h3>
199199 text_max_length = 75
200200 url_max_length = 3000
201201 value_max_length = 2000
202+ agent_prompt_max_length = 4000
202203
203204 @property
204205 def attributes(self) -> Set[str]: # type: ignore[override]
205- return super().attributes.union({"text", "url", "value", "style", "confirm", "accessibility_label"})
206+ return super().attributes.union(
207+ {
208+ "text",
209+ "url",
210+ "value",
211+ "style",
212+ "confirm",
213+ "accessibility_label",
214+ "agent_prompt",
215+ "agent_prompt_display",
216+ "visible_to_user_ids",
217+ }
218+ )
206219
207220 def __init__(
208221 self,
@@ -214,6 +227,9 @@ <h3>Inherited members</h3>
214227 style: Optional[str] = None, # primary, danger
215228 confirm: Optional[Union[dict, ConfirmObject]] = None,
216229 accessibility_label: Optional[str] = None,
230+ agent_prompt: Optional[str] = None,
231+ agent_prompt_display: Optional[str] = None,
232+ visible_to_user_ids: Optional[List[str]] = None,
217233 **others: dict,
218234 ):
219235 """An interactive element that inserts a button.
@@ -245,6 +261,12 @@ <h3>Inherited members</h3>
245261 accessibility_label: A label for longer descriptive text about a button element.
246262 This label will be read out by screen readers instead of the button text object.
247263 Maximum length for this field is 75 characters.
264+ agent_prompt: A prompt sent to Slackbot when the button is clicked, if Slackbot AI is available to the user.
265+ Maximum length for this field is 4000 characters.
266+ agent_prompt_display: Short text shown instead of the full agent_prompt in the user's Slackbot message.
267+ Only takes effect alongside agent_prompt and defaults to the button's text.
268+ visible_to_user_ids: User IDs for which the button appears.
269+ If not provided, the button is visible to all users.
248270 """
249271 super().__init__(action_id=action_id, type=self.type)
250272 show_unknown_key_warning(self, others)
@@ -256,6 +278,9 @@ <h3>Inherited members</h3>
256278 self.style = style
257279 self.confirm = ConfirmObject.parse(confirm) # type: ignore[arg-type]
258280 self.accessibility_label = accessibility_label
281+ self.agent_prompt = agent_prompt
282+ self.agent_prompt_display = agent_prompt_display
283+ self.visible_to_user_ids = visible_to_user_ids
259284
260285 @JsonValidator(f"text attribute cannot exceed {text_max_length} characters")
261286 def _validate_text_length(self) -> bool:
@@ -275,7 +300,11 @@ <h3>Inherited members</h3>
275300
276301 @JsonValidator(f"accessibility_label attribute cannot exceed {text_max_length} characters")
277302 def _validate_accessibility_label_length(self) -> bool:
278- return self.accessibility_label is None or len(self.accessibility_label) <= self.text_max_length</ code > </ pre >
303+ return self.accessibility_label is None or len(self.accessibility_label) <= self.text_max_length
304+
305+ @JsonValidator(f"agent_prompt attribute cannot exceed {agent_prompt_max_length} characters")
306+ def _validate_agent_prompt_length(self) -> bool:
307+ return self.agent_prompt is None or len(self.agent_prompt) <= self.agent_prompt_max_length</ code > </ pre >
279308</ details >
280309< div class ="desc "> < p > Block Elements are things that exists inside of your Blocks.</ p >
281310< p > < a href ="https://docs.slack.dev/reference/block-kit/block-elements/ "> https://docs.slack.dev/reference/block-kit/block-elements/</ a > </ p >
@@ -315,6 +344,15 @@ <h3>Inherited members</h3>
315344< dd > A label for longer descriptive text about a button element.
316345This label will be read out by screen readers instead of the button text object.
317346Maximum length for this field is 75 characters.</ dd >
347+ < dt > < strong > < code > agent_prompt</ code > </ strong > </ dt >
348+ < dd > A prompt sent to Slackbot when the button is clicked, if Slackbot AI is available to the user.
349+ Maximum length for this field is 4000 characters.</ dd >
350+ < dt > < strong > < code > agent_prompt_display</ code > </ strong > </ dt >
351+ < dd > Short text shown instead of the full agent_prompt in the user's Slackbot message.
352+ Only takes effect alongside agent_prompt and defaults to the button's text.</ dd >
353+ < dt > < strong > < code > visible_to_user_ids</ code > </ strong > </ dt >
354+ < dd > User IDs for which the button appears.
355+ If not provided, the button is visible to all users.</ dd >
318356</ dl > </ div >
319357< h3 > Ancestors</ h3 >
320358< ul class ="hlist ">
@@ -329,6 +367,10 @@ <h3>Subclasses</h3>
329367</ ul >
330368< h3 > Class variables</ h3 >
331369< dl >
370+ < dt id ="slack_sdk.models.blocks.block_elements.ButtonElement.agent_prompt_max_length "> < code class ="name "> var < span class ="ident "> agent_prompt_max_length</ span > </ code > </ dt >
371+ < dd >
372+ < div class ="desc "> < p > The type of the None singleton.</ p > </ div >
373+ </ dd >
332374< dt id ="slack_sdk.models.blocks.block_elements.ButtonElement.text_max_length "> < code class ="name "> var < span class ="ident "> text_max_length</ span > </ code > </ dt >
333375< dd >
334376< div class ="desc "> < p > The type of the None singleton.</ p > </ div >
@@ -2611,6 +2653,7 @@ <h3>Inherited members</h3>
26112653< li > < code > < b > < a title ="slack_sdk.models.blocks.block_elements.ButtonElement " href ="#slack_sdk.models.blocks.block_elements.ButtonElement "> ButtonElement</ a > </ b > </ code > :
26122654< ul class ="hlist ">
26132655< li > < code > < a title ="slack_sdk.models.blocks.block_elements.ButtonElement.action_id_max_length " href ="#slack_sdk.models.blocks.block_elements.InteractiveElement.action_id_max_length "> action_id_max_length</ a > </ code > </ li >
2656+ < li > < code > < a title ="slack_sdk.models.blocks.block_elements.ButtonElement.agent_prompt_max_length " href ="#slack_sdk.models.blocks.block_elements.ButtonElement.agent_prompt_max_length "> agent_prompt_max_length</ a > </ code > </ li >
26142657< li > < code > < a title ="slack_sdk.models.blocks.block_elements.ButtonElement.attributes " href ="#slack_sdk.models.blocks.block_elements.InteractiveElement.attributes "> attributes</ a > </ code > </ li >
26152658< li > < code > < a title ="slack_sdk.models.blocks.block_elements.ButtonElement.get_non_null_attributes " href ="../basic_objects.html#slack_sdk.models.basic_objects.JsonObject.get_non_null_attributes "> get_non_null_attributes</ a > </ code > </ li >
26162659< li > < code > < a title ="slack_sdk.models.blocks.block_elements.ButtonElement.logger " href ="#slack_sdk.models.blocks.block_elements.BlockElement.logger "> logger</ a > </ code > </ li >
@@ -5211,6 +5254,7 @@ <h4><code><a title="slack_sdk.models.blocks.block_elements.BlockElement" href="#
52115254< li >
52125255< h4 > < code > < a title ="slack_sdk.models.blocks.block_elements.ButtonElement " href ="#slack_sdk.models.blocks.block_elements.ButtonElement "> ButtonElement</ a > </ code > </ h4 >
52135256< ul class ="">
5257+ < li > < code > < a title ="slack_sdk.models.blocks.block_elements.ButtonElement.agent_prompt_max_length " href ="#slack_sdk.models.blocks.block_elements.ButtonElement.agent_prompt_max_length "> agent_prompt_max_length</ a > </ code > </ li >
52145258< li > < code > < a title ="slack_sdk.models.blocks.block_elements.ButtonElement.text_max_length " href ="#slack_sdk.models.blocks.block_elements.ButtonElement.text_max_length "> text_max_length</ a > </ code > </ li >
52155259< li > < code > < a title ="slack_sdk.models.blocks.block_elements.ButtonElement.type " href ="#slack_sdk.models.blocks.block_elements.ButtonElement.type "> type</ a > </ code > </ li >
52165260< li > < code > < a title ="slack_sdk.models.blocks.block_elements.ButtonElement.url_max_length " href ="#slack_sdk.models.blocks.block_elements.ButtonElement.url_max_length "> url_max_length</ a > </ code > </ li >
0 commit comments